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Preface 


H.-is  manual  documents  the  use  and  simple  customization  of  the  display  editor  HMACS  with  the 
ITS  operating  system.  The  reader  is  not  expected  to  he  a  programmer.  Kven  simple  ciistomizalions  do  not 
icquirc  programming  skill,  but  the  user  who  is  not  interested  in  customizing  can  ignore  the  scattered 
customization  hints. 

I'll  is  is  primaiily  a  refeicnee  manual,  hut  can  also  be  used  as  a  primer.  However,  I  recommend  that  the 
newcomer  first  use  the  on-line,  lcarn-by-doing  tutorial  THACHHMACS.  by  typing  :THAC1  IHM  ACS<cr> 
while  in  IIACTRN.  With  it,  you  learn  HMACS  by  using  1-MACS  on  a  specially  designed  file  which  desciibcs 
uimmands,  lei's  you  when  to  try  them,  and  then  explains  the  results  you  see.  This  gives  a  more  vivid 
introduction  than  a  printed  manual. 

On  first  leading,  jou  need  not  make  any  attempt  to  ntemoii/c  chapters  1  and  2.  which  describe  the 
notalional  coinentions  of  the  manual  and  the  general  appearance  of  the  HMACS  display  screen.  It  is  enough 
to  be  aware  of  what  questions  ate  answeied  in  these  chapters,  so  you  can  refer  hack  when  you  later  become 
inicicstcd  in  the  answers.  After  leading  the  Basic  editing  chapter  you  should  practice  the  commands  there. 
The  next  few  chapters  describe  fundamental  techniques  and  concepts  which  arc  referred  to  again  and  again. 
It  is  best  to  understand  them  thnimighly,  experimenting  with  them  if  necessary. 

lb  find  the  documentation  on  a  pmiicular  command,  look  in  the  index  if  you  know  what  the  command  is. 
If  you  know  vaguelj  what  the  command  does,  look  in  the  command  index.  The  command  index  contains  a 
line  or  two  about  each  command,  and  a  cross-reference  to  the  section  of  the  manual  which  describes  the 
command  in  more  detail.  Related  commands  arc  grouped  together.  There  is  also  a  glossary,  with  a  cross 
reference  for  each  tcim. 

The  manual  is  available  in  three  forms:  the  published  form,  the  1  1*T  form,  and  the  INFO  form.  ITic 
published  form  is  piimcd  In  the  Aililicial  Intelligence  lab.  ‘Hie  l  .l’T  font;  is  available  on  line  for  printing  on 
unsophisticated  hard  copy  devices  such  as  terminals  and  line  printers.  ’Ihc  INFO  form  is  for  on-line  penis.il 
with  the  INI  'O  program.  All  three  forms  are  substantially  the  same.  Ilierc  arc  also  two  versions  of  the  text: 
one  for  use  with  I  I  S.  and  one  for  use  with  Twcncx,  DFC’s  "TOPS-20"  system.  Both  versions  arc  available  in 
ail  three  forms. 

HMACS  is  available  for  distribution  for  use  on  I’cncx  and  Twcncx  systems  (It  docs  not  run  on  Bottoms-10, 
and  the  conversion  would  not  be  easy).  Mail  us  a  2400  foot  mag  tape  if  you  want  it.  It  docs  not  cost  anything; 
instead,  you  must  join  the  HMACS  software-sharing  commune,  ihc  conditions  of  membership  arc  that  you 
must. semi  back  any  improvements  von  make  to  HMACS.  including  any  libraries  you  write,  and  that  you  must 
not  redistribute  the  system  except  exactly  as  you  got  it,  complete.  (You  can  also  distribute  your 
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customi/ations,  separately.)  It  ispathctic  to.  hear. from  siteswhich  received. incomplete  copies,  lacking  the 
sources,  asking  me  years  later*  whether  sources  arc, available. 

For  information  on  tlic  underlying  philosophy  bf-KMAOS.and  the.  lessons  learned- from  its  development, 
write  to  me  for  a  copy  of  Al  memo  519,  "HMACS,  the  Hxtcnsiblc,  Customizable  Self-Documenting  Display 
l-'ditor",  or  send  Arpanet  mail  to  RMS@MIT-AI 


Yours  in  hacking, 

/  2  \  1/2 
<  X  > 

\  / 

Richard  M:  Stallman 
MIT  Artificial  Intelligence  lab 
545  Tech  Square.-nn  913 
Cambridge.  MA  02139 
(617)253-6765 
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Introduction 

You  arc  about  to  read  about  KMACS.  an  advanced,  self-documenting,  customizable,  extensible  real-time 
display  editor. 

We  say  that  l-'M  ACS  is  a  display  editor  because  normally  the  text  ocing  edited  is  visible  on  the  screen  and 
is  updated  automatically  as  you  type  your  commands.  See  section  1  {Display],  page  5. 

We  call  it  a  real-time  editor  because  the  display  is  updated  very  frequently,  usually  after  each  character  or 
pair  of  characters  the  user  types.  This  minimi/es  the  amount  of  information  you  must  keep  in  your  head  as 
you  edits.  See  section  3  { basic],  page  13. 

We  call  l-'M  ACS  advanced  because  it  provides  facilities  that  go  beyond  simple  insertion  and  deletion: 
lilling  of  text:  automatic  indentation  of  ptograms:  viewing  two  files  at  once:  and  dealing  in  terms  of 
chaiacteis.  words,  lines,  sentences,  paragraphs,  and  pages,  as  well  as  expressions  and  comments  in  several 
different  programming  languages.  It  is  much  easier  to  type  one  command  meaning  "go  to  the  end  of  the 
paragraph"  than  to  find  the  desired  spot  with  repetition  of  simpler  commands. 

Self-documenting  means  that  at  any  time  you  can  type  a  special  character,  the  ”1  lelp”  key .  to  find  out  whal 
your  options  arc.  You  can  also  use  it  to  find  out  vvhal  any  command  does,  or  to  find  all  the  commands  that 
peitain  to  a  topic.  See  section  7  [I  lelp],  page  29. 

Customizable  means  that  you  can  change  the  definitions  of  KMACS  commands  in  little  ways.  For 
example,  if  you  use  a  programming  language  in  which  comments  start  with  <**  and  end  w  ith  **>.  you  can  tell 
the  KMACS  comment  manipulation  commands  to  use  those  strings.  Another  soil  of  customization  is 
rearrangement  of  the  command  set.  For  example,  if  you  prefer  the  four  basic  cursor  motion  commands  (up, 
down,  left  and  right)  on  keys  in  a  diamond  pattern  on  the  keyboard,  you  can  have  it.  See  section  22.1 
[MinorModcs],  page  1 1 1. 

Kxtcnsible  means  that  you  can  go  beyond  simple  customization  and  write  entirely  new  commands, 
programs  in  the  language  TKCO.  KMACS  is  an  "online  extensible"  system,  which  means  that  it  is  divided 
into  many  functions  which  call  each  other,  any  of  which  can  be  redefined  in  the  middle  of  an  editing  session. 
\ny  part  oil 'MAC’S  can  lie  replaced  without  making  a  separate  copy  of. ill  of  KMACS.  Many  already  written 
extensions  are  distributed  with  KMACS.  and  some  (including  DIKKO.  I‘A(»K,  I’lCIUKK.  SORT.  I  A(JS, 
and  WOK  DA  II)  aie  documented  in  this  manual.  Although  only  a  progi.niinicr  can  write  an  extension, 
any  hotly  can  use  it  afterward. 


Fix  tension  requires  programming  in  TKCO,  a  rather  obscure  language.  If  you  arc  clever  and  hold,  you 
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1.  The  Organization  of  the  Screen 

1-MACS  divides  the  screen  into  several  areas,  each  of  which  contains  its  own  sorts  of  information.  'Hie 
biggest  area,  of  course,  is  the  one  in  which  you  usually  see  the  text  you  arc  editing.  'Iltc  terminal's  cursor 
usually  appears  in  the  middle  of  the  text,  showing  ‘he  position  of  "point",  the  location  at  which  editing  takes 
place.  While  the  cursor  appears  to  point  at  a  character,  point  should  be  thought  of  as  between  two  characters: 
it  points  before  the  character  that  the  cursor  appears  on  top  of.  Terminals  have  only  one  cursor,  and  when 
output  is  in  progress  it  must  appear  where  the  typing  is  being  done.  ITiis  dues  not  mean  that  point  is  moving. 
It  is  only  that  I -MACS  has  no  way  to  show  you  the  location  of  point  except  when  the  terminal  is  idle. 

Hie  C-X  -  command  tells  you  precisely  what  is  in  the  text,  if  it  is  not  clear  from  tire  display.  (If  you  area 
beginner,  don't  worry  if  yon  don't  understand  this  paragraph).  It  prints  the  row  and  column  of  the  location  of 
the  cursor  on  the  screen,  and  the  numeric  code  for  the  character  after  the  cursor.  See  section  1 1.4  (l-llling). 
page  47. 

Hie  top  lines  of  the  screen  arc  usually  available  for  text  but  arc  sometimes  pre-empted  by  an  '  error 
message",  which  says  that  some  command  you  gave  was  illegal  or  used  improperly,  or  by  typeout  from  a 
command  (such  as.  a  listing  of  a  flic  directory).  ’Iltc  error  message  or  typeout  appears  there  for  your 
information,  hut  it  is  not  part  of  the  file  you  arc  editing,  and  it  goes  away  if  you  type  any  command.  If  you 
want  to  make  it  go  away  immediately  hut  not  do  anything  else,  you  can  type  a  Space.  (Usually  a  Space  inserts 
itself,  but  when  there  is  .in  error  message  or  typeout  on  die  screen  it  docs  nothing  but  get  rid  of  that.)  ITte 
terminal's  cursor  always  appears  at  the  end  of  the  error  message  or  typeout.  hut  this  does  not  mean  that  point 
has  moved.  The  cursor  moves  back  to  the  location  of  point  after  the  error  message  or  typeout  goes  sway. 

A  few  lines  at  the  bottom  of  the  screen  compose  what  is  called  "the  echo  area".  'Txhoing''  means  printing 
out  the  commands  that  von  type.  HM  ACS  commands  arc  usually  not  echoed  at  all,  but  if  you  pause  for  more 
dian  a  second  in  the  middle  of  a  multi-character  command  then  the  whole  command  (including  what  you 
have  typed  so  far)  is  echoed,  litis  behavior  is  designed  to  give  confident  users  optimum  response,  while 
giving  nervous  users  information  on  what  they  arc  doing. 

I-MACS  also  uses  the  echo  area  for  reading  and  displaying  the  arguments  for  some  commands,  such  as 
searches,  and  for  printing  information  in  response  to  certain  commands. 

Iltc  line  above  the  echo  area  is  known  as  the  "mode  line”.  It  is  the  line  that  usually  starts  with  "IwMACS 
(something)".  Its  purpose  is  to  (ell  what  is  going  on  in  the  l-MAC'S.  and  to  show  any  reasons  why  commands 
may  not  he  interpreted  in  die  standard  way.  Iltc  mode  line  is  very  important,  and  .fyou  are  surprised  by  how 
KMACS  reacts  to  your  commands  you  should  look  there  for  enlightenment 
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1.1.  The  Mode  Line 

The  normal  sito-u'ci  is  that  diameters  you  type  arc  interpreted  as  KMACS  commands.  When  this  is  so, 
you  areal  "top  level"  and  the  mode  line  has  this  format: 

EMACS  type  (major  minor)  bfr:  file  --pos--  * 

"type”  is  usually  not  there.  When  it  is  there,  it  indicates  that  the  KMACS  job  you  arc  using  is  not  an 
ordinary  one.  in  that  it  is  acting  as  the  servant  of  some  other  job.  A  type  of  "I.KDIT'  indicates  an  KMACS 
serving  one  or  more  Lisps,  while  a  type  of  "MAILT"  indicates  an  KMACS  which  you  got  by  asking  for  an 
“edit  escape"  while  composing  mail  to  send.  The  type  can  also  indicate  a  subsystem  which  is  running,  such  as 
RMAIL.  Ihe  type  is  stored  internally  as  a  string  in  the  variable  I -di  tor  Type.  The  variable  is  normally  zero. 

"major"  is  always  the  name  of  the  “major  mode”  you  arc  in.  At  any  time.  KMACS  is  in  one  and  only  one 
of  its  possible  major  modes.  'Ihe  major  modes  available  include  Kundaincnlai  mode.  Text  mode  (which 
KMACS  starts  out  in).  Lisp  mode.  PASCAL  mode,  and  others.  See  section  20  (Major  Modes),  page  87.  for 
details  «if  how  the  modes  differ  and  how  to  select  one.  Sometimes  the  name  of  the  majoi  mode  is  followed 
immediately  with  another  name  inside  square-brackets  (”{  - )").  This  name  is  called  the  "suhmode".  Ihe 
submode  indicates  dial  you  arc  "inside”  of  a  command  which  causes  your  editing  commands  to  be  changed 
temporarily,  but  does  not  change  nluii  text  you  arc  editing.  A  sobmodc  is  a  kind  of  recursive  editing  level. 
See  section  6.2  [Suhmodes],  page  26. 

"minor"  is  a  list  of  some  of  the  minor  modes  which  arc  turned  on  at  the  moment.  ”1-111”  means  that  Auto 
I-lit  mode  is  on.  "Save”  means  that  Auto-saving  is  on.  ”Savc(off)"  means  that  Auto-saving  is  on  in  general 
but  momentarily  turned  off  (it  was  overridden  the  last  time  a  file  was  selected).  "Atom"  incans  that  Atom 
Word  mode  is  on.  "Abbrev”  means  that  Word  Abbrcv  mode  is  on.  "Ovw-'i"  means  that  Overwrite  mode  is 
on.  See  section  22.*  (Minor  Modes],  page  1 1 1,  for  more  information.  "Del"  means  that  a  keyboard  macro  is 
being  defined:  although  this  is  not  exactly  a  minor  mode,  it  is  still  useful  to  be  reminded  about  Sec 
section  22.8  {Keyboard  Macros],  page  124. 

"bfr"  is  the  name  of  the  currently  selected  buffer.  Kadi  buffer  has  its  own  name  and  holds  a  file  being 
edited:  thK  is  how  KMACS  can  hold  several  files  at  once.  Hut  at  any  time  you  ate  editing  only  one  of  them, 
tile  "selected"  buffer.  When  *c  sjwak  of  what  some  command  docs  to  "the  buffer",  we  are  talking  about  the 
currently  selected  buffer.  Multiple  buffers  makes  it  easy  to  switch  around  between  several  files,  and  then  it  is 
very  useful  that  the  mode  line  tells  you  which  one  you  are  editing  at  any  time.  However,  before  you  learn 
how  to  use  multiple  buffers,  you  will  always  be  in  the  buffer  called  "Main",  which  is  the  only  one  which  exists 
when  KMACS  starts  up.  If  the  name  of  the  buffer  is  the  same  as  the  fitsl  name  of  the  file  you  arc  visiting, 
then  the  buffer  name  is  left  out  of  the  mode  line.  See  section  14  (Buffers],  page  67.  for  how  to  use  more  than 
one  buffer  in  one  KMACS. 
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"file"  is  the  name  of  the  tile  that  you  are  editing,  it  is  the  last  file  that  was  visited  in  the  buffer  you  tire  in. 
If  "(RO)"  (for  "read  only")  appears  after  the  filename,  it  means  that  if  you  visit  another  file  in  the  same 
buffer  then  changes  you  have  made  to  this  file  will  be  lost  unless  you  have  explicitly  asked  to  save  them.  See 
section  13.1  | Visiting],  page  55,  for  more  information.  If  there  is  no  "(RO)"  and  you  visit  anothet  file  in  the 
same  buffer,  HMACS  will  offer  to  save  your  changes  first,  if  there  arc  any  changes. 

The  star  at  the  end  of  the  mode  line  means  that  there  arc  changes  in  the  buffer  which  have  not  been  saved 
in  the  file.  If  the  file  has  not  been  changed  since  it  was  read  in  or  saved,  there  is  no  star. 

"pos"  tells  you  whether  there  is  additional  text  above  the  top  of  the  screen,  or  below  the  bottom.  If  your 
file  is  small  and  it  is  all  on  the  screen,  -pos-  is  omitted.  Otherwise,  it  is  --TOP--  if  you  arc  looking  at  the 
beginning  of  the  file.  -HOT-  if  you  are  looking  at  the  end  of  the  file,  or  -nn%--  where  nil  is  the  percentage 
of  the  file  abo\c  the  lop  of  the  screen. 

Sometimes  you  will  see  -MORH-  instead  of  --1111%--.  This  happens  when  typeout  from  a  command  is  too 
long  to  fit  on  the  scieen.  It  means  that  if  you  type  a  Space  the  next  sciccnful  of  information  will  be  printed. 
If  you  are  not  interested,  typing  anything  but  a  Space  will  cause  the  rest  of  the  output  to  be  discarded.  Typing 
a  Ruboul  will  discaid  the  output  and  do  nothing  else.  Typing  any  other  command  will  discard  the  rest  of  the 
output  and  also  do  the  command.  When  the  output  is  discarded,  TI.USIIHD"  is  printed  after  the 
-MORI-:-. 

So  much  for  what  the  mode  line  says  at  top  level.  When  the  mode  line  doesn't  start  with  "HMACS",  and 
doesn’t  look  anything  like  the  breakdown  given  above,  then  HMACS  is  not  tit  top  level,  mid  your  typing  will 
not  be  undcislood  in  the  usual  way.  This  is  because  you  are  inside  a  subsystem,  such  as  INI-'O  (Sec 
section  6.1  (Subsystems),  page  25.),  or  in  a  recursive  editing  level,  such  as  Kdit  Options  (Sec  section  6.2 
[Recursive  Hditing),  page  26.).  The  mode  line  tells  you  what  command  you  arc  inside. 

If  you  tire  accustomed  to  other  display  editors,  you  may  be  surprised  that  HMACS  does  not  always  display 
the  page  number  and  line  number  of  point  in  the  inode  line.  This  is  because  the  text  is  stored  in  a  way  which 
makes  it  difficult  to  compute  this  information.  Displaying  them  all  the  time  would  be  too  slow  to  be  borne. 
When  you  want  to  know  the  page  and  line  number  of  point,  you  must  ask  for  the  information  with  the  M-X 
What  Page  command.  See  section  18  IPagc.s),  page  79.  However,  once  you  arc  adjusted  to  HMACS,  you  will 
rarely  have  any  reason  to  be  concerned  with  page  numbers  or  line  numbers. 
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2.  Character  Sets  and  Command  Input  Conventions 


In  this  chapter  we  introduce  the  terminology  and  concepts  used  to  talk  about  KM  ACS  commands.  In 
particular.  KM  ACS  is  designed  for  a  kind  of  keyboard  with  two  special  shift  keys  which  can  type  512  different 
characters,  instead  of  the  128  which  ordinary  ASCII  keyboards  can  send. 


2.1.  The  9-hit  Command  Character  Set 


■4  ->■ 


KMAC'S  is  designed  ideally  to  be  used  with  tciminals  whose  kcyboaids  have  a  pair  of  shift  keys,  labelled 
"Control"  and  "Meta”,  either  or  both  of  which  can  he  combined  with  any  character  that  you  can  type.  These 
shift  keys  produce  "Control"  characters  and  "Mela"  characters,  which  ate  the  editing  commands  of  KMACS. 
Culinary  characters  like  "A"  which  arc  neither  Control  nor  Meta  arc  used  for  inserting  text.  We  name  each 
of  these  characters  by  prefixing  "Control-"  or  "Meta-"  (abbreviated  "C-"  and  "M-")  to  the  character:  thus. 
Meta-K  or  M-K  is  the  diameter  which  is  I-  typed  with  the  Meta  key  held  down.  Control  in  the  KMACS 
command  character  set  is  not  precisely  the  same  as  Control  in  die  ASCII  character  set.  but  the  general 
purpose  is  die  same. 


I'lie  1 28  characteis,  multiplied  by  (lie  four  possibilities  of  .lie  Control  and  Meta  keys,  make  512  characters 
in  die  KMACS  command  character  set.  So  it  is  called  the  512-characler  set  to  distinguish  it  from  ASCII, 
which  has  only  128  characteis.  it  is  also  called  die  "9-bil"  character  set  because  9  bits  arc  required  to  express 
a  number  from  0  to  51 1.  Note  that  the  512-character  set  is  used  only  for  keyboard  commands.  Characters  in 
files  being  edited  with  KMACS  arc  ASCII  characters. 

Sadly,  most  terminals  do  not  have  ideal  KMACS  keyboards.  In  fact,  the  only  ideal  keyboards  arc  at  MIT. 
On  non  ideal  keyboards,  the  Control  key  is  somewhat  limited  (it  can  be  combined  with  only  some  other 
characters,  not  with  all),  and  the  Meta  key  may  not  exist  at  all.  We  make  it  possible  to  use  KMACS  on  a 
nonidcal  terminal  by  providing  two-characlci  circumlocutions,  made  up  of  characteis  that  you  can  type,  for 
the  characters  that  you  can't  type.  These  circumlocutions  stall  with  a  "bit  prefix  cbaiacter”:  see  below.  Also 
see  the  appendix  for  more  detailed  information  on  what  to  do  on  your  type  of  terminal. 


It  may  seem  an  unfortunate  coincidence  that  both  the  KMACS  9-bil  character  set  and  the  ASCII  character 
set  use  the  term  "Control"  for  not  exactly  the  same  thing.  This  came  about  because  the  9-bil  character  set  was 
invented  by  generalizing  ASCII.  In  ASCII,  only  letters  and  a  few  puncluallotf  marks  can  be  made  into 
Control  characters;  we  wanted  to  have  a  Control  version  of  every  character.  Kor  example,  we  have 
Control-Space,  Control-digits,  and  Control-  =  .  We  also  have  Conlrol-A  and  Control-a  which  are  two 
different  characters;  however,  all  such  pairs  have  the  same  meaning  as  KMACS  commands,  so  you  can  forget 
about  this  quirk  of  the  character  set  unless  you  begin  customizing.  In  practice,  you  can  forget  all  about  the 
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distinction  between  ASCII  Control  and  HMACS  Control,  except  to  realize  that  HMACS  uses  some  "Control" 
characters  which  are  not  on  your  keyboard. 

In  addition  to  the  9-bit  command  character  set,  there  is  one  extra  character  called  Help.  It  cannot  be 
combined  with  Control  or  Meta.  Its  use  is  to  ask  for  documentation,  at  any  time,  l.ike  the  the  9-bit 
characters,  the  I  ielp  character  has  its  own  key  on  an  ideal  keyboard,  but  must  be  represented  by  something 
else  on  other  keyboards.  The  circumlocution  we  use  is  Control-_  H  (two  characters).  Hie  code  used 
internally  for  Help  is  41  JO  (octal). 

We  have  given  some  command  characters  special  names  which  we  always  capitalize.  "Return"  or  "<cr>" 
stands  for  the  carriage  return  character,  code  015  (all  character  codes  arc  in  octal).  Note  that  C-R  means  the 
character  Contiol-R.  never  Return.  "Rubout"  is  the  character  with  code  177,  labeled  "Delete"  on  some 
keyboards.  "Ahmodc"  is  the  character  with  code  033,  sometimes  labeled  "Escape".  Other  command 
characters  with  special  names  toe  Tab  (code  Oil),  backspace  (code  010).  Linefeed  (code  012),  Space  (code 
040).  Exci  ("!".  code  041),  Comma  (code  054),  and  Period  (code  056).  Control  is  represented  in  the  numeric 
code  for  a  character  by  200,  and  Mela  by  400;  thus,  Meta-Period  is  code  456  in  the  9-bit  character  set 

2.2.  Prefix  Charjtclers 

A  non-ideal  keyboard  can  only  send  certain  Control  characters,  and  may  completely  lack  the  ability  to 
send  Meta  characters.  To  use  these  commands  on  such  keyboards,  you  need  to  use  two-character 
circumlocutions  starting  will)  a  "bit  prefix"  character  which  turns  on  the  Control  or  Meta  bit  in  the  second 
character.  The  Altmodc  character  turns  on  the  Mela  bit,  so  Altmode  X  can  be  used  to  type  a  Meta-X.  and 
Altmodc  Control-0  can  be  used  to  type  a  C-M-O.  Alunode  is  known  as  "the  Metizer".  Other  bit  prefix 
characters  arc  C-~  for  Control,  and  C-C  for  Control  and  Meta  together.  Thus,  C-'s  <  is  a  way  of  typing  a 
ControK,  and  C-C  <  can  be  used  to  type  C-M-C.  Because  C-~  is  awkward  to  type  on  most  keyboards,  we 
have  tried  to  minimize  the  number  of  commands  for  which  you  will  need  it. 

There  is  another  prefix  character,  C’ontrol-X  which  is  used  as  the  beginning  of  a  large  set  of  two-character 
commands  known  as  "C-X  commands".  C-X  is  not  a  bit  prefix  character,  C-X  A  is  not  a  circumlocution  for 
any  single  character,  and  it  must  be  typed  as  two  characters  on  any  terminal. 

2.3.  Commands,  l< unctions,  anti  Variables 

Most  of  the  HMACS  commands  documented  herein  are  members  of  this  9-bit  character  set.  Others  arc 
pairs  of  characters  from  that  set.  However,  HMACS  doesn’t  really  define  commands  directly.  Instead, 
HMACS  defines  "functions",  which  have  long  names  such  as  "'R  Down  Real  Line",  and  then  the  functions 
arc  connected  to  "commands"  such  as  C-N  through  a  dispatch  table.  When  we  say  that  C-E  moves  die  cursor 
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down  a  line  we  arc  glossing  over  a  distinction  illicit  is  unimportant  for  ordinary  use.  but  essential  for 
customization:  it  is  the  function  *R  Down  Real  l.inc  which  knows  how  to  move  down  a  line,  and  C-N  moves 
down  a  line  because  it  is  connected  to  that  function.  We  usually  ignore  this  subtlety  to  keep  things  simple.  To 
gi\e  the  extension-writer  the  information  he  needs,  we  state  the  name  of  the  function  which  really  does  the 
work  in  parentheses  after  mentioning  the  command  name.  For  example:  "C-N  (~R  Down  Real  l.inc)  moves 
the  ctiisor  down  a  line",  in  the  KM  ACS  wall  chart,  the  function  names  are  used  as  a  form  of  very  brief 
documentation  for  the  command  characters.  See  section  5.2  [Functions],  page  21. 

The  "~R  "  which  appears  at  the  front  of  the  function  name  is  simply  part  of  the  name.  By  convention,  a 
ccitain  class  of  functions  have  names  which  statt  with  "~R  ”. 

While  we  arc  on  the  subject  of  customization  information  which  you  should  not  be  fiiglucncd  of,  it’s  a 
good  time  to  tel!  you  about  variables.  Often  the  description  of  a  command  w  ill  say  "to  change  this,  set  the 
vaiiable  Mumble  boo".  A  variable  is  a  name  used  to  remember  a  value.  F.MACS  contains  many  variables 
which  arc  theic  so  that  you  can  change  them  if  you  want  to  customize.  The  variable's  value  is  examined  by 
some  command,  and  changing  the  value  makes  the  command  behave  differently.  Until  you  are  interested  in 
customizing,  you  can  ignore  this  information.  When  you  arc  ready  to  be  interested,  read  the  basic 
information  on  variables,  and  then  the  information  on  individual  variables  will  make  sense.  See  section  22.3 
[Variables],  page  114. 

2.4.  Nolalional  Conventions  for  ASCII  Chat  sifters 

Control  characters  in  tiles,  your  KM  ACS  buffet,  or  TKCO  programs,  arc  oulinary  ASCII  chaructm  and 
arc  represented  as  upa.iovv  or  caret  followed  by  the  corresponding  non-control  character:  control-!-  is 
represented  as  tK.  1  he  special  9-bit  character  set  applies  only  to  typing  KM  ACS  commands. 

CR1.F  is  the  traditional  term  fora  carriage  return  followed  by  a  linefeed.  This  sequence  of  two  characters 
is  what  separates  »;>•.  .  m  text  being  edited.  Normally,  KMACS  commands  make  this  sequence  appear  to  be  a 
single  character,  but  iTCO  code  must  deal  with  the  realities.  A  return  or  a  linefeed  which  is  not  part  of  a 
CKKK  is  called  "stray".  KMACS  usually  treats  them  as  part  of  the  line  and  displays  them  as  tM  and  tj. 

Other  ASCII  characters  with  special  names  include  tab  (control-!.  Oil),  backspace  (controi-H,  010), 
linefeed  (eonboi  J,  012).  alimodv  (03.1).  space  ((HO),  ami  i  about  (177).  Tab  and  conlrol-I  are  different  as  9-bit 
I'onun.im!  ih.nai  tors,  bus  when  calmed  (o  ASCII  they  become  the  same.  Our  convention  is  that  names  of 
AS(  'll  channels  are  in  lower  vase,  while  names  of  v  hit  comm:::*!  characters  arc  in  uppercase. 

Most  conttol  cliar.k  tc.s  when  proM.nl  :n  the  KMACS  buffer  arc  displayed  with  a  caret;  thus,  ■'A  for  ASCII 
t  A.  Ruhout  is  displayed  as  '?,  because  by  stretching  the  meaning  of  "control”  it  can  be  interpreted  as  ASCII 
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control-?.  A  backspace  is  usually  displayed  as  AH  since  it  is  ASCII  control-H,  because  most  displays  cannot 
do  overprinting. 

Altmode  is  the  ASCII  code  0.13  sometimes  labeled  "1-scape"  or  "Alt".  Altmodc  is  often  represented  by 
itself  in  this  document  (remember,  it  is  an  ASCII  character  and  can  therefore  appear  in  files).  It  looks  like 
this:  ♦.  On  some  terminals,  altmodc  looks  just  like  the  dollar  sign  character.  If  that’s  so  on  yours,  you  should 
assume  that  anything  you  see  in  the  on-line  documentation  which  looks  like  a  dollar  sign  is  really  an  altmodc 
unless  you  are  specifically  told  it’s  a  dollar  sign.  Hie  dollar  sign  character  is  not  paiticularly  important  in 
KMAC’S  and  we  will  rarely  have  reason  to  mention  it 
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3.  Basic  Editing  Commands 

Wc  now  give  the  basics  of  how  to  enter  text,  make  corrections,  and  save  the  text  in  a  file.  If  tills  material  is 
new  to  you.  you  might  learn  it  more  easily  by  running  die  TKACH  KM  ACS  program. 

3.1.  Inserting  Text 

To  inseit  printing  characters  into  the  text  you  are  editing,  just  type  them.  Normally  (when  KMACS  is  at 
top  level),  they  arc  inserted  into  the  text  at  the  cursor,  which  moves  forwaid.  Any  characters  after  the  cursor 
move  Ibiuard  too.  If  the  cursor  is  in  between  a  KOO  and  a  BAR.  typing  XX  produces  and  displays 
KOOXXBAR  with  (he  cursor  before  the  "B".  This  method  of  insertion  works  for  printing  characters  and 
space,  but  other  characters  act  as  editing  commands  and  do  not  insert  themselves.  If  you  need  to  insert  a 
control  character.  Altmodc.  Tab  or  Rubout.  you  must  quote  it  by  typing  the  C-Q  command  first.  "C"  refers 
to  the  Contiol  hit.  See  section  2  (Charactcis],  page  9. 

To  correct  text  you  have  just  insetted,  you  can  use  Rubout.  Rubout  deletes  the  character  Inj'oie  the  cursor 
(not  the  one  that  the  cuisor  is  on  top  of  or  under;  that  is  the  chaiactcr  aficr  the  cursor).  The  cursor  and  all 
charactcis  after  it  move  backwards.  You  can  rub  out  a  line  boundary  by  typing  Rubout  when  the  curst.,  is  at 
the  beginning  of  a  line. 

To  end  a  line  and  start  typing  a  new  one,  type  Return  (~R  CRI.K).  You  can  also  type  Return  to  break  an 
existing  line  into  two.  A  Rubout  after  a  Return  will  undo  it.  Return  really  inserts  two  characters,  a  carriage 
return  and  a  linefeed  (a  CRI.K).  but  almost  everything  in  KMACS  makes  them  look  like  just  one  character, 
which  you  can  think  of  as  a  line-separator  character. 

If  you  add  too  many  characters  to  one  line,  without  breaking  it  with  a  Return,  the  line  will  grow  to  occupy 
two  (or  more)  lines  on  the  screen,  with  a  "I"  at  the  extreme  right  margin  of  all  but  the  last  of  them.  Hie  "!" 
says  that  the  following  screen  line  is  not  really  a  distinct  line  in  the  file,  but  just  the  "continuation”  of  a  line 
too  long  to  lit  the  screen. 

3.2.  Moving  f  lic  Cursor 

To  do  moie  than  insert  charactcis.  you  have  to  know  how  to  move  the  cursor.  Ileie  are  a  few  of  the 
loiiiiuands  fordoing  that. 

C-A  Moves  to  the  beginning  of  the  line. 

C’-K  Moves  lo  the  end  of  the  line. 

C-K  Moves  forward  over  one  character. 
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C-B  Moves  backward  over  one  character. 

C-N  Moves  down  one  line,  vertically.  If  you  start  in  the  middle  of  one  line,  you  end  in  the 
middle  of  the  next.  From  the  last  line  of  text,  it  creates  a  new  line. 

C-P  Moves  up  one  line,  vertically. 

C-l.  Clears  the  screen  and  reprints  everything.  C-U  C-l .  reprints  just  the  line  that  the  cursor  is 
on. 

C-T  Transposes  t'  laracters  (the  ones  before  and  after  the  cursor). 

M-<  Moves  to  die  of  your  text. 

M->  Mores  to  the  Ci.a  of  your  text. 


3.3.  Erasing  Text 

Rubout  I  )cletc  the  character  before  the  cursor. 

C-l )  1  )clete  the  character  after  the  cursor. 

C-K  Kill  to  the  end  of  the  line. 

*1  on  already  know  about  the  Rollout  command  which  deletes  the  character  before  the  cursor.  Another 
command.  Control*!),  deletes  the  character  after  the  cursor,  causing  the  rest  of  the  text  on  the  line  to  shift  left. 
I  f  Conti  ol-l)  is  typed  at  the  end  of  a  line,  that  line  and  the  next  line  arc  joined  together. 

To  erase  a  larger  amount  of  text,  use  the  Control-K  command,  which  kills  a  line  at  a  lime.  IfConlrol-K  is 
done  at  the  beginning  or  middle  of  a  line,  it  kills  all  the  text  up  to  the  end  of  the  line.  If  Control-K  is  done  at 
the  end  of  a  line,  it  joins  that  line  and  the  next  line. 

See  section  9.1  {Killing],  page  35,  for  more  flexible  ways  of  killing  text. 


3.4.  Files 

The  commands  above  are  sufficient  for  creating  text  in  the  KM  ACS  buffer,  ilic  more  advanced  K.MACS 
commands  just  make  things  easier.  But  to  kc^p  any  text  permanently  you  must  put  it  in  a  file.  You  do  that 
by  choosing  a  filename,  such  as  FOO,  and  typing  C-X  C-V  FOCKcrX  Ibis  "visits"  the  file  I •'00  (actually, 
l-'OO  >  on  your  working  directory)  so  that  its  contents  appear  on  the  screen  for  editing.  You  can  make 
changes,  and  then  "save”  the  file  by  typing  C-X  C-S.  This  makes  the  changes  permanent  and  actually 
changes  the  file  KOO.  Until  then,  die  changes  are  only  inside  your  K.MACS,  and  the  file  l-'OO  is  not  really 
changed.  If  the  file  1-00  doesn't  exist,  and  you  waul  to  create  it,  visit  it  as  if  it  did  exist.  When  you  save  your 
text  with  C-X  C-S  die  file  will  be  created. 

Of  course,  there  is  a  lot  more  to  learn  about  using  files.  See  section  13  (Mies],  page  55. 
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3.5.  Help 

If  you  forget  what  a  command  does,  you  can  find  out  with  die  Help  character,  'llic  Help  character  is 
Top- 1 1  if  you  have  a  Top  key.  or  Control-.  II  (two  characters!)  otherwise.  Type  I  lelp  followed  by  C  and  the 
command  you  want  to  know  about.  I  lelp  can  help  you  in  other  ways  as  well.  See  section  7  [I  lelp}.  page  29. 

3.6.  Using  Blank  Lines  Can  Make  Editing  Faster 

C-0  Insert  one  or  more  blank  lines  after  the  cursor. 

C-X  C-0  Delete  all  but  one  of  many  consecutive  blank  lines. 

One  thing  you  should  know  is  that  it  is  much  more  efficient  to  insert  text  at  the  end  of  a  line  than  in  the 
middle.  So  if  you  want  to  stick  a  new  line  before  an  existing  one,  it  is  better  to  make  a  blank  line  there  first 
and  then  type  the  text  into  it.  lather  than  inserting  the  new  text  at  the  beginning  of  the  existing  line  and  then 
insert  a  line  separator.  It  is  also  clearer  what  is  going  on  while  you  are  in  the  middle. 

To  make  a  blank  line,  you  can  type  Return  and  then  C-B.  But  there  is  a  single  character  for  this:  C-0 
(Customi/.ers:  this  is  the  built-in  function  “R  Open  Line).  So.  instead  of  typing  FOO  Return  to  inseit  a  line 
containing  FOO,  type  C-0  FOO.  If  you  want  to  insert  many  lines,  you  should  type  many  C-0  s  at  the 
beginning  (or  you  can  give  C-0  an  argument  to  tell  it  1  >w  many  blank  lines  to  make.  See  section  4 
[Arguments},  page  17,  for  how).  As  you  then  insert  lines  of  text,  you  will  notice  that  Return  behaves 
strangely:  it  "uses  up"  the  blank  lines  instead  of  pushing  them  down.  If  you  don't  use  up  all  the  blank  lines, 
you  can  type  C-X  C-0  (the  function  "R  Delete.  Blank  Lines)  to  get  rid  of  all  but  one.  C-X  C-0  on  a  blank 
line  among  many  blank  lines  reduces  them  to  one.  C-X  C-0  on  a  nonblank  line  deletes  any  blank  lines  which 
follow. 
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4.  Giving  Numeric  Arguments  to  EMACS  Commands 

I 
l 

Any  KMACS  coinmanJ  can  be  given  <i  numeric  argument.  Some  commands  interpret  die  argument  as  a 
repetition  count.  I  or  ex  a  nplc,  Jv  ing  an  argument  of  ten  to  die  C-F  command  (move  forward  one  character) 
mwfo  forward  ten  characters.  With  these  commands,  no  argument  is  equivalent  to  an  argument  of  one. 

Some  commands  care  only  about  w  hether  there  is  an  argument,  and  not  about  its  value;  for  example,  the 
command  .vl-Q  CR  Fill  Paragraph)  with  no  arguments  fills  text,  but  with  an  argument  justifies  the  text  as 
well. 

Si.inc  commands  use  the  value  of  the  argument,  but  do  something  peculiar  when  there  is  no  argument, 
l  oi  example,  the  C-K  ('R  Kill  I  .inc)  command  with  an  argument  <n>  kills  <n>  lines  and  the  line  separators 
that  follow  them.  But  C-K  with  no  argument  is  special;  it  kills  the  text  up  to  the  next  line  separator,  or.  if 
point  is  right  at  the  end  of  the  line,  it  kills  the  line  separator  itself.  Thus,  two  C-K  commands  with  no 
arguments  can  kill  a  nonblank  line,  just  like  C-K  with  an  argument  of  one. 

The  fundamental  way  of  specifying  an  argument  is  to  use  the  C  U  (~R  Universal  Argument)  command 
followed  by  the  optional  minus  sign  and  the  digits.  C-U  followed  by  a  non-digit  other  than  a  minus  sign  has 
the  special  meaning  of  "multiply  by  four".  It  multiplies  the  argument  for  the  next  command  by  four.  Two 
such  C  U’s  multiply  it  by  sixteen.  Thus,  C-U  C-U  C-F  moves  foiward  sixteen  characters.  It  is  a  good  way  to 
move  forward  "fast”,  since  it  moves  about  1/4  of  a  line  on  most  terminals.  Other  useful  combinations  arc 
C-U  C-N.  C-U  C-U  C-N  (move  down  a  good  fraction  of  a  screen),  C-U  C-U  C-0  (make  "a  lot"  ofblank 
lines),  and  C-U  C-K  (kill  four  lines).  With  commands  like  M-Q  that  care  whether  there  is  an  argument  but 
not  what  the  value  is.  C-U  is  a  good  way  of  saying  "I  want  an  argument". 

A  few  commands  treat  a  plain  C-U  differently  from  an  ordinary  argument.  A  few  others  may  treat  an 
argument  of  just  a  minus  sign  differently  from  an  argument  of -1.  These  unusual  cases  will  be  described 
when  they  come  up;  they  arc  always  for  reasons  of  convenience  of  use. 

Iliere  arc  other,  terminal-dependent  ways  of  specifying  arguments.  They  have  the  same  effect  but  may  be 
easier  to  type.  See  the  appendix.  If  your  terminal  has  a  numeric  keypad  which  sends  something  recognizably 
different  from  the  ordinary  digits,  it  is  possible  to  program  FMAC’S  to  allow  use  of  the  numeric  keypad  for 
specifying  arguments.  Hie  lihiuiics  VT52  and  VTJOO  provide  such  a  feature  for  those  two  types  of  terminals, 
See  section  22.2  |I.ibrarics|,  page  1 12. 
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5.  Extended  (Meta-X)  Commands  and  Functions 

M-X  Regin  an  extended  command.  Follow  by  command  name  and  arguments. 

C-M-X  Begin  an  extended  command.  Follow  by  the  c<  mmand  name  only:  the  command  will 

ask  lor  any  arguments. 

C-X  Alunode 

Re-exccutc  recent  extended  command. 

While  the  most  often  useful  l-MACS  commands  arc  accessible  via  one  or  two  characters,  the  less  often 
used  commands  go  by  long  names  to  make  them  easier  to  remember.  ‘Ibcv  arc  known  as  "extended 
commands"  because  they  extend  the  set  of  two-character  commands.  'Ibcy  arc  also  called  "M-X  commands", 
because  they  all  statt  with  the  character  Meta-X  (~R  Fxtcnded  Command).  The  M-X  is  followed  by  the 
command's  name,  actually  the  name  of  a  function  to  be  called.  Terminate  the  name  of  the  function  with  a 
Return  (unless  you  are  supplying  string  arguments:  see  below).  For  example.  Meta-X  Auto  Fill  Modc<cr> 
in \ukcs  the  function  Auto  Fill  Mode.  Ibis  function  when  executed  turns  Aul*  •  ill  mode  on  or  off. 

Wc  say  that  M-X  Foo<cr>  calls  "the  function  FOO”.  When  documenting  the  individual  extended 
commands,  we  will  call  thorn  "functions"  to  avoid  confusion  between  them  and  the  one  or  two  character 
"commands".  Wc  will  also  use  "M-X"  as  a  title  like  "Mr."  for  functions,  as  in  "use  M-X  Foo".  Ibe 
"extended  command"  is  what  you  type,  starting  with  M-X.  and  what  the  command  dues  is  call  a  function. 
Ilie  name  that  goes  in  the  command  is  the  name  of  the  command  and  is  also  the  name  of  the  function,  and 
both  terms  will  he  used. 

5.!.  Issuing  Extended  Commands 
5. 1. 1.  Typing  The  Command  Name 

When  you  type  M-X,  the  cursor  moves  down  to  die  echo  area  at  the  bottom  of  the  screen.  ”M-X"  is 
ptinleJ  there,  and  when  you  type  the  command  name  it  echoes  there.  'Ibis  is  known  as  ’’reading  a  line  in  the 
cello  area".  You  can  use  Rubbot  to  cancel  one  character  of  the  command  name,  or  C-U  or  C-D  to  cancel  the 
entire  command  name.  A  C-G  cancels  the  whole  M-X.  and  so  does  a  Rollout  when  the  command  name  is 
empty.  These  editing  characters  apply  to  anything  which  reads  a  line  in  the  echo  area. 

Ilie  string  "M-X"  which  appears  in  the  echo  area  is  called  a  "prompt”.  ’Ibc  prompt  always  tells  you  what 
sort  of  argument  is  required  and  what  it  is  going  to  be  used  for;  "M-X"  means  that  you  arc  inside  of  the  M-X 
command  and  should  type  (he  name  of  a  function  to  be  called. 
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5-1-2.  Completion 

You  can  abbreviate  the  name  of  the  command.  as  long  as  the  abbreviation  is  unambiguous.  You  can  also 
use  completion  on  the  function  name,  'litis  means  that  you  type  part  of  the  command  name,  and  KMACS 
visibly  tills  in  me  rest,  or  as  much  as  can  he  determined  from  the  part  you  have  typed. 

You  request  completion  by  typing  an  Altmodc.  For  example,  if  you  type  M-X  Au  Altmodc.  the  "Au" 
expands  to  "Auto  *'  because  all  command  names  which  start  with  "Au"  continue  with  "to  If  you  ask  for 
completion  when  there  arc  several  alternatives  for  die  next  character,  the  bell  rings  and  nothing  else  happens. 
Altmodc  is  also  the  way  to  terminate  die  command  mime  and  begin  the  string  arguments,  but  it  only  docs  this 
if  the  command  name  completes  in  full.  In  that  ease,  an  Alunodc  (♦)  appears  after  die  command  name  in  the 
echo  area,  (if  the  command  name  docs  not  complete  in  full,  it  Is  ambiguous,  so  it  would  be  useless  to  type  the 
arguments  yet). 

Space  is  another  way  to  request  completion,  but  it  completes  only  one  word.  Successive  Spaces  complete 
one  word  each,  until  either  there  arc  multiple  Possibilities  or  the  end  of  die  name  is  reached.  If  the  first  word 
of  a  command  is  Kdit.  List.  Kill.  View  or  What,  it  is  sufficient  to  type  just  die  first  letter  and  complete  it  with  a 
Space.  ('I  his  does  not  follow  from  the  usual  definition  of  completion,  since  the  single  letter  is  ambiguous;  it  is 
a  special  feature  added  because  these  words  arc  so  common). 

Typing  "?'*  ii.  the  middle  of  the  command  name  prints  a  list  of  all  die  command  names  which  begin  with 
what  you  have  typed  so  far.  You  can  then  go  oil  typing  the  name. 


5.1.3.  Numeric  Arguments  anti  String  Arguments 

Some  functions  can  use  numeric  prefix  arguments.  Simply  give  die  Meta-X  command  an  argument  and 
Meta-X  will  pas  it  along  to  the  function  which  it  calls.  ’Ilic  argument  appears  before  the  "M-X”  in  the 
prompt,  as  in  "69  M-X",  to  remind  you  that  the  function  you  call  will  receive  a  numeric  argument 

Some  functions  require  “string  arguments"  or  "suffix  arguments".  For  those  functions,  die  function  name 
is  terminated  with  a  single  Alunodc,  after  which  come  the  arguments,  separated  by  Allnmdcs.  After  the  Iasi 
argument,  type  a  Return  to  cause  the  function  to  be  executed,  l-or  example,  the  function  Describe  prints  the 
full  documentation  of  a  function  (or  a  variable)  whose  name  must  be  given  as  a  string  argument.  An  example 
of  using  it  is  Meta-X  I X-scrihc»Apnipos<cr>.  which  prints  the  full  description  of  the  function  named 
Apropos. 

Ail  alternate  way  of  calling  extended  commands  is  with  die  command  C’-M-X  (•'R  Instant  Intended 
Command).  It  differs  from  plain  M-X  in  dial  die  function  itself  reads  any  siring  arguments,  'lliis  can  be 
useful  if  the  siring  argument  is  a  filename  or  a  command  name,  because  the  function  knows  that  and  gives  the 
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argument  special  treatment  such  as  completion.  However,  there  arc  compensating  disadvantages.  For  one 
thing,  since  the  function  lias  already  been  invoked,  you  can’t  rub  out  from  the  arguments  into  the  function 
name.  For  another,  it  is  not  possible  to  save  the  whole  thing,  function  name  and  arguments,  for  you  to  recall 
with  C-X  Altmodc  (see  below).  So  C-M-X  saves  nothing  for  C-X  Altmode.  The  prompt  for  C-M-X  is 
"C-M-X”.  You  can  merride  it  with  the  variable  Instant  Command  Prompt. 

5.1,4.  Repealing  an  Extended  Command 

The  last  few  extended  commands  you  have  executed  arc  saved  and  you  can  repeat  them.  We  say  that  the 
extended  command  is  saved,  rather  than  that  the  function  is  saved,  because  the  whole  command,  including 
arguments,  is  saved. 

To  re-execute  a  saved  command,  use  the  command  C-X  Altmode  (*R  Rc-cxcculc  Minibuffer).  It  retypes 
the  last  extended  command  and  ask  for  confirmation.  With  an  argument,  it  repeats  an  earlier  extended 
command;  2  means  repeat  the  next  to  the  last  command,  etc.  You  can  also  use  the  miiiibuffer  to  edit  a 
piewous  extended  command  and  re-execute  it  with  changes  (Sec  section  2.5 1 M inibuffei],  page  127.). 

Note:  Hx tended  commands  and  functions  were  once  called  "MM  commands",  but  this  tcim  is  obsolete.  If 
you  see  it  in  any  user  documentation,  please  report  it.  Ordinary  one  or  two  character  commands  used  to  be 
known  as  "~R"  commands,  and  the  term  may  still  be  used  in  the  online  documentation  of  some  functions; 
please  report  this  also. 

5.2.  Arcane  Information  about  IVI-X  Commands 

You  can  skip  this  section  if  you  arc  not  interested  in  customization,  unless  you  want  to  know  what  is  going 
on  behind  the  scenes. 

5.2.1.  MM 

1 -A tended  commands  wcie  once  called  "MM  commands,  because  "MM"  is  a  THCO  expression  which 
looks  up  a  command  name  to  find  the  associated  program,  and  runs  that  program.  Thus,  the  THCO 
expression 

MM  Apropos$Word» 

means  to  tun  the  Apropos  command  with  the  argument  "word".  You  could  type  this  expression  into  a 
minihulfer  and  get  the  same  results  as  you  would  gel  from  Meta-X  A  propose  Word<cr>.  In  fact,  for  (lie  first 
year  or  so,  KM  ACS  had  no  Mcla-X  command,  and  that's  what  people  did.  See  section  23  [MinibulTcrj, 
page  127,  for  information  on  the  miiiibuffer. 
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"MM"  actually  tells  THCO  to  call  the  subroutine  in  q-registcr  "M".  ITic  first  "M"  means  "call",  and  the 
second  "M"  says  what  to  call.  ‘Ibis  subroutine  takes  a  string  argument  which  is  the  name  of  a  function  and 
looks  it  up.  Calling  a  function  is  built  into  THCO,  but  looking  up  the  name  is  not;  it  is  implemented  by  the 
program  THCO  calls  "M".  That's  why  "MM"  is  called  that  and  not  "Run"  or  "FtQ". 

5.2.2.  Arguments  in  TECO  Code 

functions  can  use  one  or  two  "prefix  arguments"  or  "numeric  arguments".  'Ibese  arc  numbers  (actually, 
IHCO  expressions)  which  go  before  the  "MM".  Meta-X  can  only  gi\e  the  MM  command  one  argument.  If 
you  want  to  give  it  two,  you  must  type  it  in  using  the  minibuffer.  When  IT'CO  code  passes  prefix  arguments, 
they  don’t  have  to  be  numbers;  they  can  also  be  strings.  IT'CO  buffer  objects,  etc.  However,  no  more  about 
that  here. 

When  I  KC’O  code  passes  a  string  argument,  it  appears  terminated  by  an  Altmodc  after  the  Altmode  which 
ends  the  function  name.  Thcie  can  be  any  number  of  string  arguments.  In  fact,  the  function  can  decide  at 
run  time  how  many  string  arguments  to  read.  This  makes  it  impossible  to  compile  THCO  code! 

5.2.3.  Commands  ami  Functions 

Actually,  every  command  in  I'M  ACS  simply  runs  a  function,  for  ex  .tuple,  when  you  type  the  command 
C-N,  it  runs  the  function  "~R  Down  Real  Line".  You  could  just  as  well  do  C-U  1  M-X  "It  Down  Real 
I  ine<ci>  and  get  the  same  effect.  C-N  can  be  thought  of  as  a  sort  of  abbreviation.  We  say  that  the  command 
C-N  has  been  "connected"  to  the  function  "R  Down  Real  Line.  'Hie  name  is  looked  up  once  when  lire 
command  and  function  are  connected,  so  Quit  it  docs  not  have  to  be  looked  up  again  each  time  the  command 
is  used.  Tot  historical  >  casons,  the  default  argument  passed  to  a  function  which  is  connected  to  a  command 
you  typed  is  I,  but  the  default  for  MM  and  for  M-X  is  0.  This  is  why  the  C-U  1  was  necessary  in  the  example 
above.  I  he  documentation  for  individual  HMACS  commands  usually  gives  the  name  of  the  function  which 
really  implements  live  command  in  parentheses  after  the  command  itself. 

Just  as  any  function  can  be  called  directly  with  M-X,  so  almost  any  function  can  be  connected  to  a 
command.  This  is  the  basis  ofctislomi/aiion  of  HMACS.  You  can  use  the  function  Set  Key  to  do  this.  To 
define  C-N,  you  could  type  M-X  Set  Key$~R  Down  Real  Line<cr>,  and  then  type  C-N.  If  you  use  the 
film  lion  View  l-’ile  often,  you  could  connect  it  to  the  command  C-X  V  (not  normally  defined).  You  could 
even  connect  it  to  the  command  t '  M-V.  icplacing  that  command’s  normal  definition.  'Ibis  can  be  done  with 
the  limclion  Set  Key;  or  yon  can  use  an  suit  file  to  do  it  permanently.  See  section  22.7  |lnil],  page  120. 
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5.2.4.  Subroutines  and  Built-in  Functions 

FMACS  is  composed  of  a  large  number  of  functions,  each  with  a  name.  Some  of  these  functions  arc 
connected  to  commands:  some  arc  there  for  you  to  call  with  M-X;  some  arc  called  by  other  functions.  The 
last  group  arc  called  subroutines.  They  usually  have  names  starting  with  as  in  "&  Read  Line",  the 
subroutine  which  reads  a  line  in  the  echo  area.  Although  most  subroutines  have  such  names,  any  function 
can  be  called  as  a  subroutine.  Functions  like  "R  Down  Real  Line  have  names  starting  with  -R  because  you 
aic  not  expected  to  call  them  directly,  either.  The  purpose  of  the  or  "*R"  is  to  get  those  function  names 
out  of  the  way  of  command  completion  in  M-X.  M-X  allows  the  command  name  to  be  abbreviated  if  the 
abbreviation  is  unique,  and  the  commands  that  you  arc  not  interested  in  might  have  names  that  would 
interfere  and  make  some  useful  abbreviation  cease  to  be  unique.  The  funny  characters  at  the  front  of  the 
name  pi  event  this  from  happening. 

Some  function  names,  present  as  definitions  of  single-character  commands,  are  known  to  all  the  Help 
features  but  don't  seem  to  exist  if  you  try  to  call  them  by  name.  The  names  of  these  functions  ore  not  always 
defined;  they  arc  contained  in  a  library  called  BARF  which  is  loaded  temporarily  by  each  documentation 
command  and  then  Hushed  again.  'I  he  reason  for  this  is  that  these  functions  are  really  built  into  TFC‘0  and 
not  part  of  FMACS:  the  FMAC'S  "definitions"  aren’t  nccessaiy  for  actually  using  them,  and  arc  only  there 
for  the  sake  of  documentation.  If  you  load  BARF  permanently,  then  you  can  refer  to  these  functions  by 
name  like  all  others.  See  section  22.2  |l.ibrarics|,  page  1 12. 
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6.  Moving  Up  Ami  Down  Levels 

Subsystems  and  recursive  editing  levels  are  two  states  in  which  you  arc  temporarily  doing  something  other 
than  editing  the  visited  file  as  usual.  For  example,  you  might  be  editing  a  message  that  you  wish  to  send,  or 
looking  at  a  documentation  file  with  INFO. 

6.1.  Subsystems 

\  subsystem  is  ;m  HMACS  function  which  is  an  interactive  program  in  its  own  right:  it  reads  commands  in 
a  language  of  its  own,  and  displays  the  icsiilts.  You  enter  a  subsystem  by  typing  tin  HMACS  command  which 
invokes  it.  Once  eiiteied.  the  subsystem  runs  until  a  specific  command  to  exit  the  subsystem  is  typed.  An 
example  of  an  l-MACS  subsystem  is  INFO,  the  documentation  leading  progitim.  Others  are  backtrace  and 
II  M-.lUiCi.  ii‘\u  ib"  debugging  TFCO  programs,  and  KM  All.  and  HAUYL,  used  for  leading  and  editing  mail 
files. 

I  he  commands  iindei stood  by  a  subsystem  tae  usually  not  like  l-MACS  commands,  because  their  purpose 
is  something  other  than  editing  text.  For  example,  INFO  commands  arc  designed  for  moving  around  in  a 
tiee-structured  documentation  lile.  In  HMACS.  most  commands  tire  Control  or  Meta  characters  because 
printing  characters  inscit  themselves.  In  most  subsystems,  there  is  no  insertion  of  text,  so  non-Control 
noii-iVleta  characters  can  be  the  commands. 

While  you  arc  inside  a  subsystem,  (lie  mode  line  usually  gives  the  name  of  the  subsystem  (as  well  as  other 
information  supplied  by  the  subsystem,  such  as  the  filename  and  node  name  in  INFO).  You  can  tell  that  you 
are  inside  a  subsystem  because  the  mode  line  docs  not  start  with  "l-MACS",  or  with  an  open  bracket  ("[") 
which  would  indicate  a  recursive  editing  level.  Sec  section  1.1  (Mode  1  .ine],  page  6. 

because  each  subsystem  implements  its  own  commands,  we  cannot  guarantee  anything  about  thcrii 
I  lowcvcr,  there  are  conventions  for  what  certain  commands  ought  to  do: 

C-]  aboits  (exits  w  ithout  finishing  up) 

backspace  Scrolls  backward,  like  M-V  in  HMACS. 

Space  Sciolls  forward,  like  C-V  in  HMACS. 

Q  Hxits  normally. 

X  begins  an  extended  command,  like  M-X  in  HMACS. 

I  lelp  or  ?  Prints  documentation  on  the  subsystem's  commands. 


Not  all  of  these  necessarily  exist  in  every  subsystem,  however. 
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6.2.  Recursive  Editing  Levels 

A  recursive  editing  level  is  a  state  in  which  you  arc  inside  a  command  which  has  given  you  some  text  for 
you  to  edit.  'Hie  text  may  or  may  not  be  part  of  the  file  you  arc  editing.  Recursive  editing  levels  arc  indicated 
in  the  mode  line  by  square  brackets  ("I"  and 

For  example,  the  command  M-X  Fdif  Options  is  for  changing  the  settings  of  KM  ACS  options  by  editing  a 
list  of  option  names  and  values.  You  use  the  same  commands  as  always  for  making  changes  in  this  list;  when 
you  arc  finished,  the  changes  take  affect  in  your  option  settings.  While  you  are  editing  the  list  of  options,  die 
mode  line  says  "[Edit  Options)".  See  section  22.3  J  Variables),  page  i  14. 

A  recursive  editing  level  differs  from  a  subsystem  in  that  the  commands  arc  ordinary  FMACS  commands 
(though  a  handful  may  have  been  changed  slightly),  whereas  a  subsystem  defines  its  own  command  language. 

The  text  you  edit  inside  a  recursive  editing  level  depends  on  the  command  which  invoked  the  recursive 
editing  level.  It  could  be  a  list  of  options  and  values,  or  a  list  of  tab  stop  settings,  syntax  table  settings,  a 
message  to  be  sent,  or  any  text  that  you  might  wish  to  compose. 

Sometimes  in  a  iccursivc  editing  level  you  edit  text  of  the  file  you  are  visiting,  just  as  at  top  level.  Why 
would  this  be?  Usually  because  a  few  commands  arc  temporarily  changed.  For  example.  I  'd i t  Picture  in  the 
PICTURE  library  defines  commands  good  for  editing  a  picture  made  out  c."  characters,  then  enters  a 
iccuisive  editing  level.  When  you  exit,  the  special  picture-editing  commands  go  away.  Until  then,  the 
biackcts  in  the  mode  line  serve  to  remind  you  that,  although  the  text  you  are  editing  is  your  file,  all  is  not 
normal.  See  section  26  [PICTURE),  page  151. 

In  any  ease,  if  the  mode  line  says  “[...]”  you  arc  inside  a  recursive  editing  level,  and  the  way  to  exit  (send 
the  message,  redefine  the  options,  get  rid  of  the  picture-editing  commands,  etc.)  is  with  the  command 
Control-Altmodc  or  C-M-C  CR  Exit).  See  section  6.3  [Exiting),  page  26.  If  you  change  your  mind  about  the 
command  (you  don’t  want  to  send  the  message,  or  change  your  options,  etc.)  then  you  should  use  the 
command  C-]  (Abort  Recursive  Edit)  to  get  out.  See  section  24.1  [Aborting),  page  129. 

When  the  text  in  the  mode  line  is  surrounded  by  parentheses,  it  means  that  you  are  inside  a  "MinibtilTcr”. 
A  minibufler  is  a  special  case  of  the  recursive  editing  level.  Like  any  other,  it  can  be  abutted  safely  with  C-). 
For  full  details  on  minibuffers.  See  section  21  [Minibulfer],  page  127. 


6.3.  Exiling  Levels;  Exiling  EMACS 

C-X  C-C  Exit  from  EMACS  to  the  superior  job. 

C-M-C  Exit  from  EMACS  or  from  a  recursive  editing  level. 
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The  general  KM  ACS  command  to  exit  is  C-M-C  (~R  Kxit).  This  command  is  used  to  exit  from  a  recursive 
editing  level  back  to  the  top  level  of  l-'MACS,  and  to  exit  from  KMACS  at  top  level  back  to  1IACTRN.  If 
your  keyboard  docs  not  have  a  Meta  key,  you  must  type  this  command  by  means  of  a  bit  prefix  character,  as 
C-C  C-C  or  as  Alttnode  C-C.  Note  carefully  the  difference  between  exiting  a  recursive  editing  level  and 
aborting  it:  exiting  allows  the  command  which  invoked  the  recursive  editing  level  to  finish  its  job  with  the  text 
as  you  have  edited  it.  whereas  aborting  cancels  whatever  the  command  was  going  to  do.  See  section  24.1 
{Aborting],  page  129. 

We  cannot  say  in  general  how  to  exit  a  subsystem,  since  each  subsystem  defines  its  own  command 
language,  but  the  convention  is  to  use  the  character  "Q". 

You  can  exit  from  1-MACS  back  to  the  superior  job.  usually  HACTRN.  at  any  time,  even  within  a 
iccursivc  editing  level,  with  the  command  C-X  C-C  ('R  Return  to  Supciior).  If  this  is  used  while  you  arc 
inside  a  iccursivc  editing  level,  then  when  l-MA.CS  is  rc-cnteicd  you  will  still  be  inside  the  recursive  editing 
level. 


l-xiting  l-'MACS  does  not  normally  save  the  visited  file,  because  it  is  not  the  ease  that  users  exit  l-MACS 
only  when  they  are  "finished  editing".  Ir  you  want  the  file  saved,  you  must  use  C-X  C-S.  I  exiting  docs  cause 
an  auto  stive  if  auto  stive  mode  is  in  use. 


(exiling  from  l-MACS  urns  the  function  &  I  exit  l-’MACS,  which  executes  the  value  of  the  variable  I  exit 
Hook,  if  it  is  defined. 
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7.  Seif-Documentation  Commands 


l-MACS  provides  extensive  self-documentation  features  which  revoke  around  a  single  character,  called 
the  Help  character.  At  any  time  while  using  FMACS.  you  can  type  the  Help  character  to  ask  for  help.  How 
to  type  the  Help  character  depends  on  the  terminal  you  arc  using,  but  aside  from  that  the  same  character 
always  docs  tiic  trick.  If  your  keyboard  h.is  a  key  labeled  I  lelp  (above  the  11).  type  that  key  (together  with  the 
Top  key).  Otherwise  the  way  you  type  the  Help  character  is  actually  C-_  (Control-Underscore)  followed  by 
an  11  (this  is  two  characters  to  type,  but  let's  not  worry  about  that).  Whatever  it  is  you  have  to  type,  to 
I '.MACS  it  is  just  the  I  lelp  character.  On  some  terminals  just  figuring  out  how  to  type  a  Control-Underscore 
u  hard!  Typing  Undcrscoie  and  adding  the  Control  key  is  what  is  supposed  to  work,  but  on  some  terminals  it 
docs  not.  Sometimes  Control- Shift-0  woiks.  On  VT- *00  terminals.  Control-/  and  Control-?  send  a 
Control- _  character. 

If  you  type  I  lelp  while  you  are  using  a  subsystem  Mich  as  INFO,  it  will  give  you  a  list  of  the  commands  of 
that  subsystem. 

If  you  type  I  lelp  in  the  middle  of  a  multicharacter  command,  it  will  often  tell  you  about  what  sort  of  thing 
you  should  type  next.  I  or  example,  if  you  type  M  X  and  then  I  lelp,  it  will  tell  you  about  M-X  and  how  to 
type  the  name  of  the  command.  If  you  finish  the  function  name  and  die  Altmode  and  then  type  I  lelp.  it  will 
tell  you  about  the  function  you  have  specified  so  you  can  know  what  arguments  it  needs.  If  you  type  C-X  and 
then  type  I  lelp.  it  will  tell  you  about  the  C-X  commands. 

Hut  normally,  when  it’s  time  for  you  to  start  typing  a  new  command.  Help  offers  you  several  options  for 
asking  about  what  commands  there  arc  and  what  they  do.  It  prompts  with  "Doc  (?  for  help):"  at  the  bottom 
of  the  screen,  and  you  should  type  a  character  to  say  what  kind  of  help  you  want.  You  could  type  I  lelp  or  ”?" 
at  this  point  to  find  out  what  options  arc  available.  The  ones  you  arc  most  likely  to  need  arc  described  here. 

Ilic  most  basic  Help  options  arc  Help  C  and  Help  D.  You  can  use  them  to  ask  what  a  particular 
command  docs.  I  lelp  C  is  for  charactei  commands;  type  the  command  you  want  to  know  about  after  the 
I  lelp  and  the  "C"  ("C"  stands  for  Character).  'Iluis.  I  lelp  C  M-I-  or  Help  C  Allmode  1;  tells  you  about  the 
M-l*  command.  Help  I)  is  for  asking  about  functions  (extended  commands);  type  the  name  of  the  function 
and  a  Rcmm.  Hius,  Help  1)  I  isp  Modc<cr>  tells  you  about  M-X  I.isp  Mode.  "D”  stands  for  "Describe", 
since  I  lelp  D  actually  uses  the  function  I  Jcscribc  to  do  the  work. 

A  more  complicated  sort  or  question  to  ask  is,  "what  arc  the  commands  for  working  with  files"?  I -or  this, 
you  can  type  I  lelp  A,  followed  by  the  string  "file"  and  a  Return.  It  prints  a  list  of  all  the  functions  that  have 
"file"  anywhere  in  their  names,  including  Save  All  Files,  ~R  Save  l-'ilc.  Append  to  File,  etc.  If  some  of  the 
functions  arc  connected  to  commands,  it  will  tell  you.  For  example,  it  would  say  that  you  can  invoke 
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~R  Save  l-ilc  by  typing  C-X  C-S.  "A"  stands  for  "Apropos”,  since  Help  A  actually  uses  the  function  Apropos 
to  do  (he  substring  matching.  Help  A  does  not  list  internal  functions,  only  those  the  nonprograinmcr  is  likely 
to  use.  If  you  want  subroutines  to  be  listed  as  well,  you  must  call  Apropos  yourself. 

Because  Apropos  looks  only  for  functions  whose  names  contain  the  string  which  you  specify,  you  must  use 
ingenuity  in  choosing  substrings.  If  you  arc  looking  for  commands  for  killing  backwards  and  Help  A  Kill 
Backwards  doesn’t  reveal  any.  don’t  give  up.  'fry  just  Kill,  or  just  Backwards,  or  just  Back.  Be  persistent. 
Pretend  you  are  playing  Adventure. 

If  you  aren’t  sure  what  characters  you  accidentally  typed  to  produce  surprising  results,  you  can  use  I  Iclp  1, 
to  find  out  ("1."  stands  for  "What  1  ossage").  If  you  see  commands  that  you  don’t  know,  you  can  use  I  Iclp  C 
to  find  out  what  they  did. 

If  a  command  doesn't  do  what  you  thought  you  knew  it  should  do.  you  can  ask  to  see  whether  it  has 
changed  recently.  Help  N  prints  out  the  file  called  KM  ACS;  KM  ACS  NKWS  which  is  an  archive  of 
announcements  of  changes  to  KMACS. 

I'o  find  tint  about  the  other  I  Iclp  options,  type  I  lelp  I  Iclp.  That  is.  when  the  first  I  lelp  asks  for  an  option, 
type  I  Iclp  to  ask  w  hat  is  available. 

Kinally.  you  should  know  about  the  documentation  files  tor  KMACS,  which  arc  KMACS;KMACS 
GUlDKaml  KMACS;KMACS  CHART.  KMACS  CUIDKis  a  version  of  the  manual  formatted  to  be  printed 
out  on  a  terminal  or  line  printer.  KMACS  CHART  has  a  brief  description  of  all  the  commands,  and  is  good 
to  post  on  the  wall  near  your  terminal. 
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8.  The  Mark  and  Hie  Region 

in  general,  a  command  which  processes  an  arbitrary  part  of  the  buffer  must  know  where  to  start  and  where 
to  stop.  In  KM  ACS,  such  commands  start  at  point  and  end  at  a  place  called  the  "mark".  I  his  range  of  text  is 
called  "the  region".  I  lerc  arc  some  commands  for  setting  the  mark: 


c-(«: 

Set  the  mark  where  point  is. 

C-Spacc 

'Ibc  same. 

C-X  C-X 

Interchange  mark  and  point. 

M-(& 

Sot  maik  after  end  of  next  word. 

C-M-C« 

Set  maik  after  end  of  next  1  isp  s-cx  pression. 

C-< 

Set  maik  at  beginning  of  buffer. 

C-> 

Set  mark  at  end  of  buffer. 

M-ll 

Put  region  around  current  paragraph. 

C-M-ll 

Put  legion  around  current  Lisp  defun. 

C-X  II 

Put  region  around  entire  buffer. 

C-X  C-P 

Pm  region  around  current  page. 

l  or  example,  if  you  wish  to  concert  part  of  the  buffer  to  ail  upper-ease,  you  can  use  the  C-X  C-U 
command,  which  operates  on  the  text  in  the  region.  You  can  first  go  to  the  beginning  of  the  text  to  be 

capitalized,  put  the  mark  there,  move  to  the  end.  and  then  type  C-X  C-U.  Or,  you  can  set  the  mark  at  the  end 

\ 

of  the  text,  nunc  to  the  beginning,  and  (hen  type  C-X  C-U.  C-X  C-U  runs  the  function  AU  Uppercase 
Region,  whose  name  signifies  that  the  region,  or  everything  between  point  and  the  mark,  is  to  be  capitalized. 

I  he  most  common  way  to  set  the  mark  is  with  the  command  or  the  C-Spuee  command  (~R  Set/Pop 
Mark).  They  set  the  mark  where  point  is.  'Ilicn  you  can  move  point  away,  leaving  the  mark  behind. 

It  isn’t  actually  possible  to  type  C-Spacc  on  non-Mela  keyboards.  Yet  on  many  terminals  the  command 
appears  to  work  anyway!  ’Iliis  is  because  trying  to  type  a  Control-Space  on  those  terminals  actually  sends  the 
character  C -(?/’.  which  means  the  same  thing  .is  C-Spacc.  A  few  keyboards  just  send  a  Space.  If  you  have  one 
of  them,  you  suffer,  or  customize  your  HM  ACS. 

Since  terminals  have  only  one  cursor,  these  is  no  way  for  l-MACS  to  show  you  where  the  mark  is  located. 
You  have  to  remember.  Hie  usual  solution  to  tills  problem  is  to  set  the  maik  and  then  use  it  soon,  before  you 
forget  where  it  is.  Hut  you  can  sec  where  llie  mark  is  with  the  command  C-X  C-X  (~R  Lxchange  Point  and 
Mark)  which  puts  the  mark  where  point  was  and  point  where  the  mark  was.  'Urns,  the  previous  location  of 
the  mark  is  shown,  hut  the  region  specified  is  not  changed.  C-X  C-X  is  also  useful  when  you  arc  satisfied  with 
the  location  of  point  but  want  to  move  the  other  end  of  the  region:  do  C-X  C-X  to  pul  point  at  that  end  and 
then  you  can  adjust  it.  The  end  of  the  region  which  is  at  point  can  be  moved,  while  the  end  which  is  at  the 


32 


l-MACS  M;inual  for  ITS  Users 


If  you  insert  or  delete  before  the  mark,  the  mark  docs  not  stay  with  the  characters  it  was  between.  If  the 
buffer  contains  'T’OO  BAR”  and  the  mark  is  before  the  “B’\  then  if  you  delete  the  "F*  the  mark  will  be 
before  the  “A".  This  is  an  unfortunate  result  of  the  simple  way  the  mark  is  implemented.  It  is  best  not  to 
delete  or  insert  at  places  above  the  mark  until  you  arc  finished  using  it  and  don’t  care  where  it  drifts  to. 

8.1.  Commands  io  iVlark  Textual  Objects 

llierc  arc  commands  for  placing  the  mark  on  the  other  side  of  a  certain  object  such  as  a  word  or  a  list, 
without  having  to  move  there  first.  M-(S  CR  Mark  Word)  puts  the  mark  at  the  end  of  the  next  word,  while 
C-M  ■("  CR  Mark  Sexp)  puts  it  at  the  end  of  the  next  s-expression.  C->  ('  R  Mark  Hrnl)  puts  the  mark  at  live 
end  of  the  buffer,  while  C-<  CR  Mark  Beginning)  puts  it  at  the  beginning.  These  characters  allow  you  to 
sa\e  a  little  typing,  sometimes. 

Other  commands  set  hoth  point  and  mark,  to  delimit  an  object  in  the  buffer.  M-H  (~R  Mark  Paragraph) 
puts  point  at  the  beginning  of  the  paragraph  it  was  inside  of  (or  before),  and  puts  the  mark  at  the  end.  M-H 
does  till  that’s  necessary  if  you  wish  to  indent,  casc-convcit,  or  kill  a  whole  paragraph.  C-M-ll  (~R  Mark 
Defun)  similarly  puts  point  before  and  the  mark  after  die  current  or  next  defun.  C-X  C-P  (~R  Mark  Page) 
puts  point  before  the  current  page  (or  the  next  or  previous,  according  to  the  argument),  and  mark  at  the  end. 
'!T,e  ttiaik  goes  after  the  terminating  page  delimiter  (to  include  it),  while  point  goes  after  the  preceding  page 
delimiter  (to  exclude  it),  finally,  C-X  II  (-R  Mark  Whole  Buffer)  makes  the  region  die  entire  buffer  by 
putting  point  at  die  beginning  and  the  mark  at  the  end. 

8.2.  Tlic  King  of  Marks 

\side  from  delimiting  die  region,  die  mark  is  also  useful  for  remembering  a  spot  dial  you  may  want  to  go 
back  to.  To  make  this  feature  more  useful.  l-MACS  remembers  16  previous  locations  of  the  mark.  Most 
commands  dint  set  the  mark  push  die  old  mark  onto  this  stack.  To  return  to  a  marked  location,  use 
C-U  C-(«;’  (or  C-U  C-Spacc).  'Iliis  moves  point  to  where  the  mark  was.  and  restores  the  mark  from  the  stack 
of  former  n  arks.  So  repeated  use  of  this  command  moves  point  to  all  of  the  old  marks  on  the  stack,  one  by 
one.  Since  the  Mack  is  actually  a  ring,  enough  uses  of  C-U  €■(«'  bring  point  back  to  whcie  it  was  originally. 
Inscilioii  and  deletion  can  cause  the  saved  marks  to  drift,  hut  they  arc  still  good  for  Uiis  purpose  because  they 
arc  approximately  right. 

Some  commands  whose  primary  purpose  is  to  move  point  a  great  distance  take  advantage  of  the  .stack  of 
tanks  to  give  you  a  way  to  undo  the  command.  'Hie  best  example  is  M-<.  which  moves  to  the  beginning  of 
the  buffer.  It  sets  the  mark  first,  so  that  you  can  use  C-U  C-@  or  C-X  C-X  to  go  brick  to  where  you  were. 
Searches  sometimes  set  the  mark;  it  depends  on  how  far  they  move.  Because  of  Uiis  uncertainty,  searches 


I  he  Mark  and  the  Region 

type  out  if  they  set  the  mark.  The  normal  situation  is  tliat  searches  leave  the  mark  behind  if  they  move 
at  least  500  characters,  but  you  can  change  that  value  since  it  is  kept  in  the  variable  Auto  Push  Point  Option. 
By  setting  it  to  0.  you  can  make  all  searches  set  the  mark.  By  setting  it  to  a  very  large  number  such  as  ten 
million,  you  can  prevent  all  searches  from  setting  the  mark.  'Hie  siring  to  be  typed  out  when  this  option  docs 
its  thing  is  kept  in  the  variable  Auto  Push  Point  Notification. 
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9.  Killing  and  Moving  Text 


The  commonest  way  of  moving  or  copying  text  with  KMACS  is  to  kill  it,  and  get  it  hack  again  in  one  or 
more  places.  This  is  very  safe  because  the  last  several  pieces  of  killed  text  arc  all  remembered,  and  it  is 
versatile,  because  the  many  commands  for  killing  syntactic  units  can  also  be  used  for  moving  those  units. 
There  arc  also  other  ways  of  moving  text  for  special  purposes. 


9.1.  Deletion  and  Killing 


Most  commands  which  erase  text  from  the  buffer  save  it  so  that  you  can  get  it  back  if  you  change  your 
mind,  or  move  or  copy  it  to  other  pans  of  the  buffer.  These  commands  are  known  as  "kill"  commands.  The 
rest  of  the  commands  that  erase  text  do  not  save  it;  they  arc  known  as  "delete"  commands.  The  delete 
commands  include  C-l)  and  Rubout.  which  act  on  single  charactcis,  and  those  commands  that  delete  only 
spaces  or  line  separators.  Commands  that  can  destroy  significant  amounts  of  nontiivial  data  generally  kill. 
The  commands'  names  and  individual  descriptions  use  the  words  "kill"  and  "delete"  to  say  which  they  do.  If 
)0ti  do  a  kill  command  by  mistake,  you  can  use  the  Undo  command  to  undo  it  (See  section  2-1.3  |Undo|, 
page  132.). 


C-l) 

Rubout 

M-\ 

C-X  C-0 


M-~ 

C-K 

C-W 

M-D 

M-Rubout 
C-X  Rubout 
M-K 
C-M-K 
C-M-Rubout 


Delete  next  character. 

I  )clctc  previous  character. 

Delete  spaces  and  tabs  around  point. 

Delete  blank  lines  around  the  current  line. 

Join  two  lines  by  deleting  the  CRI.I- and  any  indentation. 
Kill  rest  of  line  or  one  or  nunc  lines. 

Kill  region  (from  point  to  die  mark). 

Kill  a  word. 

Kill  a  word  backwards. 

Kill  back  to  beginning  of  sentence. 

Kill  to  end  of  sentence. 

Kill  s-expression. 

Kill  s-expression  backwards. 


9.1.1.  Deletion 


The  most  basic  delete  commands  arc  C-l)  and  Rubout.  C-l)  deletes  the  character  alter  the  cursor  -  the  one 
the  cursor  is  "on  lop  of  or  "underneath".  The  cursor  doesn't  move.  Rubout  deletes  the  character  before  the 
cursor,  and  moves  the  cuisor  back.  Line  separators  act  like  single  characters  when  deleted.  Actually,  C-l) 
and  Rubout  aren’t  always  delete  commands;  if  you  give  an  argument,  they  kill  instead.  This  prevents  you 
from  losing  a  great  deal  of  text  by  typing  a  large  argument  to  a  C-D  or  Rubout. 
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The  oilier  delete  commands  arc  those  which  delete  only  formatting  characters:  spaces,  tabs  and  line 
separator.  M-\  UR  Delete  Horizontal  Space)  deletes  all  the  spaces  and  tab  character  before  and  after 
point.  C-X  C-0  (aR  Delete  Blank  Lines)  deletes  till  blank  lines  after  the  current  line,  and  if  the  current  line 
is  blank  deletes  all  blank  lines  preceding  tin*  an  rent  line  as  well  (leaving  one  blank  line,  die  current  line). 
M-a  UR  Delete  indentation)  joins  the  current  line  and  the  previous  line,  or  the  current  line  and  the  next  line 
ifgixcn  an  argument.  See  section  1 1.3  [Indentation),  page 46. 

A  function  AR  Delete  Region  used  to  exist,  but  it  was  too  dangerous.  When  you  want  to  delete  a  large 
amount  of  text  without  saving  a  copy  of  it  (perhaps  because  it  is  very  big),  you  can  set  point  and  mark  around 
the  text  and  then  type  M-4  M  R  K  H.  (This  is  a  use  of  the  minibuffer.  See  section  23  [Minibuffer], 
page  127.). 

9.1.2.  killing  by  Lines 

The  simplest  kill  command  is  the  C-K  command  UR  Kill  l.inc).  If  given  at  the  beginning  of  a  line,  it  kills 
all  the  text  on  the  line,  leaving  it  blank.  If  given  on  a  blank  line,  the  blank  line  disappears.  As  a  consequence, 
if  you  go  to  the  front  of  a  non-blank  line  and  type  two  OK's,  the  line  disappears  completely. 

More  generally,  OK  kills  from  point  up  to  the  end  of  the  line,  unless  it  is  at  the  end  of  a  line.  In  that  ease 
it  kills  the  line  separator  following  the  line,  thus  merging  the  next  line  into  the  current  one.  Invisible  spaces 
and  tabs  at  the  end  of  the  line  are  ignored  when  deciding  which  case  applies,  so  if  point  appeals  to  be  at  the 
end  of  the  line,  you  can  be  sure  the  line  separator  will  be  killed. 

OK  with  an  argument  of  zero  kills  all  the  text  before  point  or.  the  current  line. 

If  OK  is  given  a  positive  argument,  it  kills  that  many  lines,  and  the  separators  that  follow  them  (however, 
text  on  the  current  line  before  point  is  spared).  With  a  negative  argument,  -5  for  example,  ail  text  before 
point  on  the  current  line,  and  all  of  the  five  picccding  lines,  arc  killed. 

9.1.3.  Ollior  Kill  Commands 

A  kill  command  which  is  very  general  is  C-W  UR  Kill  Region),  which  kills  everything  between  point  and 
the  maik.  With  this  command,  you  can  kill  any  contiguous  characters,  if  you  set  the  mark  at  one  end  of  them 
and  go  to  the  other  end,  first. 

Other  syntactic  units  can  be  killed:  words,  with  M-Ruhout  and  M-D  (See  section  1 1.1  (Words),  page  43.); 
s-oxpressions,  with  C-M-Ruboul  .aid  C-M-K  (See  section  20.6.1  [S-expressions).  page  94.);  sentences,  with 
C-X  Rubout  and  M-K  (See  section  1 1 .2  [Sentences],  page  44.). 
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9.2.  Un-Killing 

Un-killing  is  getting  back  text  which  was  killed.  The  usual  way  to  move  or  copy  text  is  to  kill  it  and  then 
un-kili  it  one  or  more  times. 

C-Y  Yank  (re-insert)  last  killed  text. 

M-Y  Replace  re-inserted  killed  text  with  the  previously  killed  text. 

M-W  Save  region  as  iast  killed  text  without  killing. 

C-M-W  Append  next  kill  to  last  batch  of  killed  text. 

Killed  text  is  pushed  onto  a  ring  buffer  that  remembers  the  last  8  blocks  of  text  that  were  killed.  (Why  it  is 
called  a  "ring  buffer"  will  lie  explained  below).  The  command  C-Y  (~R  Un-kill)  reinserts  the  text  of  the 
most  recent  kill.  It  leaves  the  cuisorat  the  end  of  the  text,  and  puls  the  maik  at  die  beginning.  Thus,  a  single 
C-W  undoes  the  C-Y  (M-X  Undo  also  docs  so).  C-U  C-Y  leaves  the  cursor  in  front  of  the  text,  and  the  mark 
aftci.  This  is  only  if  the  argument  is  specified  with  just  a  C-U.  precisely.  Any  other  sort  of  argument, 
including  C-U  and  digits,  has  a:i  effect  described  below. 

If  you  wish  to  copy  a  block  of  text,  you  might  want  to  use  M-W  ("R  Copy  Region),  which  copies  the 
legion  into  the  kill  ring  without  removing  it  from  the  buffer.  This  is  approximately  equivalent  to  C-W 
followed  by  C-Y,  except  that  M-W  docs  not  mark  the  buffer  as  "changed"  and  does  not  tcmpoiarily  change 
the  screen.  Note  that  there  is  only  one  ill  ring,  and  switching  buffers  or  files  has  no  effect  on  it.  After 
visiting  a  new  file,  whatever  was  last  killed  in  the  previous  file  is  still  on  top  oflhe  kill  ring. 

9.2.1.  Appending  Kills 

Normally,  each  kill  command  pushes  a  new  block  onto  the  kill  ring.  However,  two  or  more  kill  commands 
in  a  row  combine  their  text  into  a  single  entry  on  the  ring,  so  that  a  single  C-Y  command  gets  it  all  back  as  it 
was  before  it  was  killed.  (Thus  we  join  television  in  leading  people  to  kill  thoughtlessly).  If  a  kill  command  is 
separated  from  the  last  kill  command  by  other  commands,  it  starts  a  new  entry  on  the  kill  ring,  unless  you  tell 
it  not  to  by  saying  C-M-W  (~R  Append  Next  Kill)  in  front  of  it.  The  C-M-W  tells  the  following  command,  if 
it  is  a  kill  command,  to  append  the  text  it  kills  to  the  last  killed  text,  instead  of  pushing  a  new  entry.  With 
C-M-W,  you  can  kill  several  separated  pieces  of  text  and  accumulate  (hem  to  be  yanked  back  in  one  place. 

9.2.2.  UiHvilling  Karlior  Kills 

To  recover  text  that  was  killed  some  lime  ago  (that  is,  not  the  most  recent  victim),  you  need  the  Meta-Y 
(*R  Un-kill  Pop)  command.  The  M-Y  command  should  be  used  only  after  a  C-Y  command  or  another  M-Y. 
It  takes  the  un-killcd  text  and  replaces  it  with  the  text  from  an  earlier  kill. 
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You  can  think  of  all  the  last  few  kills  as  living  in  a  ring.  After  a  C-Y  command,  the  text  at  the  front  of  the 
ring  is  also  present  in  the  buffer.  M-Y  "rotates"  the  ring,  bringing  the  previous  string  of  text  to  the  front,  and 
this  text  replaces  the  other  text  in  the  buffer  as  well.  Knough  M-Y  commands  can  rotate  any  part  of  the  ring 
to  the  front,  so  you  can  get  at  any  killed  text  as  long  as  it  is  recent  enough  to  be  still  in  the  ring.  livcntualiy  the 
ring  rotates  all  the  way  around  and  the  most  recent  killed  text  comes  to  the  front  (and  into  the  buffer)  again. 
M-Y  with  a  negative  argument  rotates  the  ring  backwards.  If  the  region  doesn’t  match  the  text  at  the  front  of 
the  ring,  M-Y  is  not  allowed  (its  definition  doesn’t  make  sense  iti  that  ease). 

In  any  ease,  when  the  text  you  arc  looking  for  is  brought  into  the  buffer,  you  can  stop  doing  M-Y’s  and  it 
will  stay  there.  It’s  really  just  a  copy  of  what's  at  the  front  of  the  ring,  so  editing  it  docs  not  change  what’s  in 
the  ring.  And  the  ring,  once  rotated,  stays  rotated,  so  that  doing  another  C-Y  gets  another  copy  of  what  you 
rotated  to  the  front  with  M-Y. 

If  you  change  your  mind  about  un-killing,  a  C-W  or  M-X  Undo  gets  rid  of  the  un-killcd  text  at  any  point, 
after  any  number  of  M-Y’s.  C-W  pushes  the  text  onto  the  ring  again.  M-X  Undo  does  not. 

If  you  know  how  many  M-Y’s  it  would  lake  to  find  the  text  you  want,  then  there  is  an  alternative.  C-Y 
w  ith  an  argument  greater  than  one  restores  the  text  the  specified  number  of  entries  down  on  the  ring.  Thus, 
C-U  2  C-Y  is  gets  the  next  to  the  last  block  of  killed  text.  It  differs  from  C-Y  M-Y  in  that  C-U  2  C-Y  docs 
not  permanently  rotate  the  ring. 

A  way  of  viewing  the  contents  of  the  kill  ring  is 
M-X  View  Q-registerT ,K<cr> 

You  must  add  one  to  the  indices  listed  by  this  command,  to  get  the  argument  to  use  with  C-Y  to  yank  any 
particular  string. 


9.3.  Other  Ways  of  Copying  Text 

Usually  we  copy  or  move  text  by  killing  it  and  un-killing  it,  but  there  arc  other  ways  that  are  useful  for 
copying  one  block  of  text  in  many  places,  or  for  copying  many  scattered  blocks  of  text  into  one  place. 

9.3.1.  Accumulating  Text 

You  can  accumulate  blocks  of  text  from  scattered  locations  either  into  a  buffer  or  into  a  lile  if  you  like. 

It 

To  append  (hem  into  a  buffer,  use  the  command  C-X  A<buffcrnamcXcr>  (AR  Append  to  Buffer),  which 
inserts  a  copy  of  the  region  into  the  specified  buffer  at  the  location  of  point  in  that  buffer,  if  there  is  no 
buffer  with  the  name  you  specify,  one  is  created,  empty.  If  you  append  text  into  a  buffer  which  is  visiting  a 
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(lie,  the  copied  text  goes  into  the  middle  of  the  text  of  the  file. 

Point  in  that  buffer  is  left  at  the  end  of  the  copied  text,  so  successive  uses  ofC-X  A  accumulate  the  text  in 
the  specified  buffer  in  the  same  order  as  they  were  copied.  If  C-X  A  is  given  an  argument,  point  in  the  other 
buffer  is  left  before  the  copied  text,  so  successive  uses  ofC-X  A  add  text  in  reverse  order. 

You  can  retrieve  the  accumulated  text  from  that  buffer  with  M-X  Insert  BufferKbuffernameXerX  ITiis 
inserts  a  copy  of  the  text  in  that  buffer  into  the  selected  buffer.  You  can  also  select  the  other  buffer  for 
editing.  Sec  section  14  [Buffets],  page  67,  for  background  infoimation  on  buffers. 

Strictly  speaking,  C-X  A  does  not  always  append  to  the  text  already  in  the  buffer.  But  if  it  is  used  on  a 
buffet  which  starts  out  empty,  it  does  keep  appending  to  the  end. 

To  accumulate  text  into  a  file,  use  the  command  M-X  Append  to  FileKfilcnameXcrX  It  adds  the  text  of 
the  region  to  the  end  of  the  specified  file.  M-X  Prepend  to  Pile  adds  the  text  to  the  beginning  of  the  file 
instead.  I  he  file  is  changed  immediately  on  disk.  If  you  wish  to  insert  the  text  into  a  copy  of  the  file  in  an 
HMACS  buffer,  you  must  append  to  that  buffer  instead. 


9.3.2.  Copying  Text  Many  Times 

When  you  want  to  insert  a  copy  of  the  same  piece  of  text  frequently,  the  kill  ring  becomes  impractical, 
since  the  text  moves  down  on  the  t  mg  as  you  edit,  and  will  be  in  an  unpredictable  place  on  the  ring  when  you 
need  it  again.  For  this  case,  you  can  use  the  commands  C-X  X  (AR  Put  Q-rcgister)  and  C-X  G  (AR  Get 
Q-tcgislcr)  to  move  the  text. 

C-X  X<q>  stoi  cs  a  copy  of  the  text  of  the  region  in  a  place  called  q-registcr  <q>.  <q>  can  be  .r  letter  or  a 
number.  This  gives  36  places  in  which  you  can  store  a  piece  of  text.  With  an  argument.  C-X  X  deletes  die 
text  as  well.  C-X  G<q>  inserts  in  the  buffcr'the  text  from  q-registcr  <qX  Normally  it  leaves  point  before  the 
text  and  places  the  mark  after,  but  with  a  numeric  argument  it  puls  point  after  the  text  and  the  mark  before. 

'Hie  q-registers  arc  important  temporary  variables  in  TI-CO  programming,’ but  you  don’t  have  to 
understand  them,  only  to  know  that  what  you  save  with  C-X  X  A  is  what  you  will  get  with  C-X  G  A. 


Do  not  to  use  q-registers  M  and  R  in  this  way,  if  you  arc  going  to  use  the  TI-CO  commands  MM  and  MR. 
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10.  Searching 

Like  miiei  editors,  FMACS  lias  commands  for  searching  for  an  occurrence  of  a  string.  Hie  search 
command  is  unusual  in  that  it  is  "incremental":  it  begins  to  scarcli  before  you  have  finished  typing  the  search 
string.  \s  you  type  in  the  search  string,  KM  ACS  shows  you  where  it  would  be  found.  When  you  have  typed 
enough  characters  to  identify  the  place  you  want,  you  can  stop, 

C-S  Search  forward. 

C-R  Search  backward. 

C-S  $  C-W  Word  search,  ignoring  whitespace. 

The  command  to  search  is  C-S  (~R  Incicniental  Search).  C-S  reads  in  characters  and  positions  the  cursor 
at  the  Inst  occurrence  of  the  characters  that  you  have  typed.  If  you  type  C-S  and  then  K.  the  cursor  moves 
right  after  the  fust  "I-"’.  Type  an  "O".  and  see  the  cursor  nunc  to  after  the  first  ’TO".  After  another  "0",  the 
cursor  is  after  the  first  ’TOO"  after  the  place  where  you  started  the  .search.  At  the  same  time,  the  ’TOO"  has 
echoed  at  the  bottom  of  the  screen. 

If  you  type  a  mistaken  character,  you  can  rub  it  out.  After  the  100.  typing  a  rubout  makes  the  "O" 
disappear  from  the  bottom  of  the  screen,  leaving  only  ’TO".  Hie  cursoi  moves  back  to  the  ’TO".  Rubbing 
out  the  ”0"  and  ”1- '  moves  the  cursor  back  to  where  you  started  the  search. 

When  you  arc  satisfied  with  the  place  you  have  reached,  you  can  type  an  Alunode.  which  stops  searching, 
leaving  the  cursor  where  the  search  brought  it.  Also,  any  command  not  specially  meaningful  in  searches  stops 
the  searching  and  is  then  executed.  'Huts,  typing  C-A  would  exit  the  search  and  then  move  to  the  beginning 
of  the  line.  Alunode  is  necessary  only  if  the  next  command  you  want  to  type  is  a  printing  character.  Rubout. 
Altmodc  or  another  search  command,  since  those  are  the  characters  that  would  not  exit  the  search. 

Sometimes  you  search  for  ’TOO"  and  find  it,  but  not  the  one  you  expected  to  find.  Ilierc  was  a  second 
1-00  that  you  forgot  about,  before  the  one  you  were  looking  for.  Then  type  another  C-S  and  the  cursor  will 
find  the  next  FOO.  This  can  be  done  any  number  of  times.  If  you  overshoot,  you  can  rub  out  the  C-S’s.  Vou 
can  also  repeat  the  search  after  exiting  it.  if  the  first  thing  you  type  after  entering  another  search  (when  the 
argument  is  still  empty)  is  a  C-S. 

IT  your  string  is  not  found  at  all,  the  echo  area  says  "Failing  1-Search”.  The  cursor  is  alter  the  place  where 
FMACS  found  as  much  of  your  suing  as  it  could.  Thus,  if  you  search  for  FOOT,  and  there  is  no  FOOT,  you 
might  see  the  cursor  alia  (lie  FOO  in  FOOI .  Al  this  point  there  are  several  things  you  can  do.  If  your  string 
was  mistyped,  you  can  rub  some  of  it  out  and  coned  it.  If  you  like  the  plate  you  have  found,  you  can  type 
Altmodc  or  some  other  FMACS  command  to  "accept  what  the  search  offered".  Or  you  can  type  C-Ci,  which 
throws  away  the  characters  Unit  could  not  be  found  (tile  "T"  in  "FOOT'),  leaving  those  that  were  found  (the 
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"i  '00"  in  "FOOT").  A  second  C-G  at  that  point  undoes  the  search  entirely. 

Ilie  C-G  "quit”  command  docs  special  tilings  during  searches;  just  what,  depends  on  the  status  of  the 
search.  If  the  search  has  found  what  you  specified  and  is  waiting  for  input,  C-G  cancels  the  entire  search. 
The  cursor  moves  back  to  where  you  started  the  search.  If  C-G  is  typed  while  the  search  is  actually  searching 
for  something  or  updating  the  display,  or  after  search  failed  to  find  some  of  your  input  (having  searched  all 
the  way  to  the  end  of  the  file),  then  only  the  characters  whr  have  not  been  found  arc  discarded.  Having 
discarded  them,  the  search  is  now  successful  and  waiting  for  more  input,  so  a  second  C-G  will  cancel  the 
entire  search.  Make  sure  you  wait  for  the  first  C-G  to  ding  the  hell  before  typing  the  second  one;  if  typed  too 
soon,  the  second  C  G  may  be  confused  with  the  first  and  effectively  lost 

You  can  also  type  OR  at  any  time  to  start  searching  backwards.  If  a  search  fails  because  the  place  you 
started  was  too  late  in  the  file,  you  should  do  this.  Repeated  C-R's  keep  looking  for  more  occurrences 
backwards.  A  C-S  starts  going  forwards  again.  C-R's  can  he  rubbed  out  just  like  anything  else.  If  yon  know 
thiit  you  want  to  search  backwards,  you  can  use  C-R  instead  of  C-S  to  start  the  search,  because  C-R  is  also  a 
command  ("R  Reverse  Incremental  Search)  to  seaich  backward.  Note  to  all  customizers;  all  this  command 
does  is  call  the  current  definition  of  ~R  incremental  Search  with  a  negative  argument 

A  non-incremental  search  is  .also  available.  Type  Allmode  right  after  the  C-S  to  get  it  Do  M-X 
Describe*"!*  String  Search<cr>  for  details.  Some  people  win.  prefer  non-incremental  searches  put  that 
function  on  Meta-S,  and  "R  Character  Search  (do  M-X  Describe*  for  details)  on  C-S.  It  can  do  one  useful 
thing  which  incremental  search  cannot:  search  for  words  regardless  of  where  the  line  breaks. 

Word  search  searches  for  a  sequence  of  words  without  regard  to  how  die  words  arc  separated.  More 
precisely,  you  type  a  string  of  many  words,  using  single  spaces  to  separate  them,  and  the  string  can  be  found 
even  if  there  arc  multiple  spaces  or  line  separators  between  the  words.  Other  punctuation  such  as  commas  or 
periods  must  match  exactly.  Hu’s  is  useful  in  conjunction  with  documents  formatted  by  text  justifiers.  If  you 
edit  while  looking  at  the  printed,  formatted  version,  you  can’t  tell  where  the  line  breaks  arc  in  the  source  file. 
With  word  search,  you  can  search  without  having  to  know. 

Word  search  is  a  special  ease  of  non-incremental  search  and  is  invoked  with  C-S  Altmodc  C-W.  This  is 
followed  by  (lie  search  string,  which  must  always  be  terminated  with  an  Allmode.  Searching  does  not  start 
until  the  final  Altmodc  is  typed. 
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11.  Commands  for  English  Text 

KM  ACS  enables  you  to  manipulate  words,  sentences,  or  paragraphs  of  his  text.  In  addition,  there  are 
commands  to  fill  text,  and  coinert  ease,  For  text-justifier  input  files,  there  are  commands  that  may  help 
manipulate  font  change  commands  and  underlining. 

Kditing  files  of  text  in  a  human  language  ought  to  he  done  using  Text  mode  rather  than  Fundamental 
mode.  Imoke  M-X  Text  Mode  to  enter  Text  inode.  Sec  section  20  [Major  Mode],  page  87.  M-X  Text  Mode 
causes  Tab  to  run  die  function  'll  Tab  to  Tab  Stop,  which  allows  you  to  set  any  tab  stops  with  M-X  Kdit  lab 
Slops  (See  section  1 1.3  ( liulcni.tiion],  page  46.).  Features  concerned  with  comments  in  programs  arc  turned 
off  except  when  explicitly  invoked.  Automatic  display  of  paicnthcsis  matching  is  turned  off.  which  is  what 
most  people  want.  Finally .  the  syntax  table  is  changed  so  that  pciiods  are  not  considered  pail  of  a  word, 
while  apostrophes,  backspaces  and  underlines  arc. 

11.1.  Word  (  oiiiiiidtids 

FMACS  has  commands  for  moving  over  or  operating  on  words.  By  convention,  they  are  all  Meta¬ 
characters. 

M-F  Move  Forward  over  a  word. 

M  -  B  Move  Back  ward  over word. 

M-l)  Kill  up  to  the  end  of  a  word. 

M-lliiboin  Kill  hack  to  the  beginning  of  a  word. 

M-<ft  Mark  the  end  of  the  next  word. 

M-T  Transpose  two  words;  drag  a  word  forward  or  backward  across  other  words. 

Notice  how  these  commands  form  a  group  that  parallels  the  character  based  commands  C-F",  C-B,  C-D, 
C-T  and  llubout.  M-(?(!  is  iclatcd  to  C-@. 

flic-  commands  Mcla-F  ('ll  Forward.  Word)  and  Meta-B  ('ll  Backward  Word)  move  forward  and 
backward  over  words.  I’hey  arc  thus  analogous  to  Control-!-'  and  Control-!),  which  move  over  single 
characters.  I. ike  their  Control-  analogues,  Meta- 1*  and  Meta-B  move  several  words  if  given  an  argument,  and 
can  he  made  to  go  in  the  opposite  direction  with  a  negative  argument.  Forward  motion  stops  right  after  the 
last  letter  of the  w'ord,  while  backward  motion  slops  light  bcfuic  the  first  letter. 

It  is  easy  to  kill  a  word  at  a  time.  Mcta-I)  ('ll  Forward  Kill  Word)  kills  the  word  after  point.  To  be 
piccisc,  it  kills  everything  from  point  to  the  place  Mcla-F  would  move  to.  Thus,  if  point  is  in  the  middle  of  a 
woid,  only  the  part  after  point  is  killed.  If  some  punctuation  comes  after  point  and  before  the  next  word,  it  is 
killed  along  with  the  word.  If  you  wish  to  kill  only  the  next  word  but  not  the  punctuation,  simply  do  Mcla-F" 
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to  get  the  end,  and  kill  the  word  backwards  with  Meta-Rubout.  Meta-D  takes  aiguments  just  like  Meta-R. 

Meta-Rubout  ("R  Backward  Kill  Word)  kills  the  word  before  point  It  kills  everything  from  point  back  to 
where  Meta-B  would  move  to.  If  point  is  after  die  space  in  "KOO,  BAR",  'TOO,  "  is  killed.  In  such  a 
situation,  to  avoid  killing  the  comma  and  space,  do  a  Meta-B  and  a  Meta-I)  instead  of  a  Meta-Rubout 

Meta-T  (~R  Transpose  Words)  moves  the  cursor  forward  over  a  word,  dragging  the  word  preceding  or 
containing  the  cursor  forward  as  well.  A  numeric  argument  serves  as  a  repeat  count.  A  negative  argument 
undoes  the  effect  of  a  positive  argument;  it  drags  die  word  behind  the  cursor  backward  over  a  word.  An 
argument  of  zero,  instead  of  doing  nothing,  transposes  the  word  at  point  with  the  word  at  mark.  In  any  ease, 
the  delimiter  characters  between  the  words  do  not  move.  Ror  example,  'TOO,  BAR"  transposes  into  "BAR. 
ROO"  rather  than  "BAR  ROO,". 

To  operate  on  the  next  n  words  with  an  operation  which  applies  between  point  and  mark,  you  can  either 
set  the  mark  at  point  and  then  move  over  die  words,  or  you  can  use  the  command  Mcta-(fl’  (~R  Mark  Word) 
which  does  not  move  point,  but  sets  the  mark  where  Meta-R  would  move  to.  They  can  be  given  arguments 
just  like  Meta-R.  The  case  conversion  operations  have  alternative  forms  that  apply  to  words,  since  they  arc 
p.uticularly  useful  that  way. 

Note  that  if  you  are  in  Atom  Word  mode  and  in  I  isp  mode,  all  the  word  commands  icgard  an  entire  l.isp 
atom  as  a  single  word.  See  section  22.1  (Minot  Modes},  page  1 1 1. 

The  woid  commands'  understanding  of  syntax  is  completely  controlled  by  the  syntax  table.  Any  character 
can.  for  example,  he  declared  to  be  a  woid  delimiter.  See  section  22.4  (Syntax  J.  page  1 15. 


1 1.2.  Sentence  anti  Paragraph  Commands 


Ihc  RMACS  commands  for  manipulating  sentences  and  paragraphs  arc  all  Meta-  commands,  so  as  to 
resemble  the  word-handling  commands. 

M-A  Move  back  to  the  beginning  of  the  sentence. 

M-H  Move  forward  to  the  end  of  die  sentence. 

M-K  Kill  this  or  next  sentence. 

M-(  Move  back  to  previous  paragraph  beginning 
M-J  Move  forward  to  next  paragraph  end. 

M-li  Put  point  and  inaik  around  tins  paragraph  (around  the  following  one.  if  between 
paragraphs). 

C-X  Rollout 

Kill  hack  to  beginning  of  sentence. 
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11.2.1.  Scnlences 


llic  commands  Mcta-A  and  Mcta-K  ("R  Backward  Sentence  and  ~R  Forward  Sentence)  move  to  the 
beginning  and  end  of  the  current  sentence,  respectively.  "Ilicy  were  chosen  to  resemble  Control-A  and 
Control-!*,  which  move  to  the  beginning  and  end  of  a  line,  but  unlike  iliosc  Control  characters  Meta-A  and 
Meta-F  if  repeated  move  over  several  sentences.  FMACS  considers  a  sentence  to  end  wherever  there  is  a 

"?"  or  ”!"  followed  by  the  end  of  a  line  or  two  spaces,  with  any  number  off's.  "]"'s.  or . s  allowed  in 

between.  Neither  M-A  nor  M-F  moves  past  the  CRI.F'or  spaces  which  delimit  the  sentence. 


Just  as  C-A  and  C  H  have  a  kill  command.  C-K.  to  go  with  them,  so  M-A  and  M-F  have  a  corresponding 
kill  commands  M-K  (~R  Kill  Sentence)  which  kills  from  point  to  the  end  of  the  sentence.  With  minus  one  as 
an  argument  it  kills  back  to  the  beginning  of  the  sentence.  1  arger  arguments  serve  as  a  repeat  count. 


Thetc  is  a  special  command.  C-X  Rollout  (“R  Backward  Kill  Sentence)  for  killing  back  to  the  beginning 
of  a  sentence,  because  this  is  useful  when  you  change  your  mind  in  the  middle  of  composing  text. 


11.2.2.  Paragraphs 

'llicre  are  similar  commands  for  moving  over  paragraphs.  Meta-j  (~R  Backward  Paragraph)  moves  to  the 
beginning  of  the  current  or  ptcviotis  paragraph,  while  Meta-)  (~R  Forward  Paragtapb)  moves  to  the  end  of 
the  current  or  next  paragraph.  Blank  lines  and  text  juslificr  command  lines  separate  paiagraphs  and  are  not 
part  of  aii}  paragraph.  Also,  an  indented  line  starts  a  new  paragraph. 

In  major  modes  for  programs  (as  opposed  to  Text  mode),  paragraphs  arc  determined  only  by  blank  lines. 
Iliis  makes  the  paragraph  commands  continue  to  be  useful  even  though  there  arc  no  paragraphs  per  sc. 

When  there  is  a  fill  prefix,  then  paragraphs  arc  delimited  by  till  lines  which  don’t  start  with  the  fill  prefix. 

When  you  wish  to  operate  on  a  paragiaph.  you  can  use  the  command  Mcla-ll  (~R  Mark  Paragraph)  to 
prepare.  This  command  puts  point  tit  the  beginning  and  mark  at  the  end  of  the  paragraph  point  was  in. 
Before  setting  the  new  mark  tit  the  end.  a  mark  is  set  at  the  old  location  of  point;  this  allows  you  to  undo  a 
mistaken  Meta-11  with  two  C-U  C-tff  's.  If  point  is  between  paragraphs  (in  a  run  of  blank  lines,  or  tit  a 
boundary),  the  paragraph  following  point  is  surrounded  uy  point  and  mark.  ’IThis.  for  example.  Meta- 1 1  C-\Y 
kills  the  paragraph  around  or  after  point. 

One  way  to  make  tin  "invisible"  paragraph  boundary  that  does  not  show  if  die  file  is  printed  is  to  put 
space-backspace  at  the  front  of  a  line.  'Hie  space  makes  the  line  appear  (to  the  FMACS  paragraph 
commands)  to  be  indented,  which  usually  means  that  it  starts  a  paragraph. 
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Hie  variable  Paragraph  Delimiter  should  be  a  YHCO  search  string  (See  section  19.3  j  l'KCO  search  strings], 
page  85.)  composed  of  various  characters  separated  by  tO’s.  A  line  whose  beginning  matches  the  search 
string  i*  cither  the  beginning  of  a  paragraph  or  a  text  justificr  command  line  part  of  no  paragraph.  If  the  line 
begins  with  period,  singlequote.  "\”  or  it  can  be  a  text  justificr  command  line:  otherwise,  it  can  be 
the  beginning  of  a  paragraph;  but  it  cannot  be  either  one  unless  Paragraph  Delimiter  is  set  up  to  recognize  it 
llnis.  ".'0  "  as  the  Paragraph  Delimiter  string  means  that  lines  starting  with  spaces  start  paragraphs,  lines 
sun  ting  with  periods  arc  text  justificr  commands,  and  all  other  nonblank  lines  are  nothing  special. 

1 1.3.  Inriculation  (omimmils  for  Text 

lab  Indents  "appropriately"  in  a  mode-dependent  fashion. 

M- Tab  Inserts  a  tab  character. 

I  .indeed  Is  the  same  as  Return  and  lab. 

M-~  Undoes  a  Linefeed.  Merges  two  lines. 

M-M  Moves  to  the  line's  first  nonblank  character. 

M-I  Indent  to  tab  stop.  In  Text  mode.  Tab  docs  this  also. 

C-MA  Indent  several  lines  to  same  column. 

C*X  Tab  Shift  block  of  lines  rigidly  right  or  left 

’Die  way  to  request  indentation  is  with  the  Tab  command.  Its  praise  cfTcct  depends  on  the  major  mode, 
ltl  Text  mode,  it  indents  to  the  next  tab  stop.  You  can  set  the  lab  stops  with  l-dit  Tab  Stops  (see  below).  I: 
you  just  want  to  insert  a  tab  character  in  the  buffer,  you  can  use  M-Tab. 

l-'or  l-'nglish  text,  usually  only  the  first  line  of  a  paragraph  should  be  indented.  So,  in  Text  mode,  new  lines 
created  by  Auto  l-'ill  mode  are  not  indented,  'litis  is  brought  about  by  setting  the  variable  Space  Indent  flag 
to  zero,  litis  way.  Auto  l-'ill  can  avoid  indenting  without  denying  you  the  use  of  Tab  to  indent.  But 
sometimes  you  want  to  have  an  indented  paragraph.  In  such  eases,  use  M-X  Kdit  indented  Text,  which  enters 
a  submode  in  which  Tab  and  Auto  bill  indent  each  line  under  the  previous  line,  and  only  blank  lines  delimit 
paragraphs.  Alternatively,  you  can  specify  a  fill  prefix  (see  below). 

To  undo  a  line-break,  whether  done  manually  or  by  Auto  l-'ill,  use  the  Meta-'1  (■'it  Delete  Indentation) 
command  to  delete  the  indentation  at  the  front  of  the  cun  cut  line,  and  die  line  boundary  as  well.  'Ilicy  arc 
replaced  by  a  single  space,  or  by  no  space  if  before  a  ")"  or  after  a  "(",  or  at  the  beginning  of  a  line.  To  delete 
just  the  indentation  of  a  line,  go  to  the  beginning  of  the  line  and  use  MeluA  ("It  Delete  Horizontal  Space), 
which  deletes  all  spaces  and  tabs  around  the  cursor. 

To  insert  an  indented  line  before  the  current  one,  do  C-A,  C-O,  and  then  Tab.  To  make  an  indented  line 
after  the  current  one,  use  C-K  Linefeed. 

To  move  over  the  indentation  on  a  line,  do  Mcla-M  or  C-M-M  (*R  Back  to  indentation).  Ilicsc 
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commands,  given  anywhere  on  a  line,  position  the  cursor  at  the  first  nonblank  character  on  the  line. 

ITicrc  arc  also  commands  for  changing  the  indentation  of  several  lines  at  once.  Control-MctaA 
CR  Indent  Region)  gives  each  line  whose  first  character  is  between  j'  t  and  mark  the  "usual"  indentation 
(as  determined  by  Tab).  Wit!)  a  numeric  argument,  it  gives  each  line  precisely  dial  much  indentation.  C-X 
Tab  (~R  Indent  Rigidly)  moves  all  of  (be  lines  in  the  region  right  by  its  argument  (left,  for  negative 
arguments). 

Usii.illv.  KMACS  uses  both  tabs  and  spaces  to  indent  If  you  don't  want  that  you  can  use  M-X  Indent 
Tabs  Mode  to  turn  the  use  of  labs  on  or  off.  To  convert  all  tabs  in  a  file  to  spaces,  you  can  use  M-X  Untabify, 
whose  argument  is  the  number  of  positions  to  assume  between  tab  stops  (default  is  8).  M-X  Tabify  performs 
the  opposite  tiaiisformation.  replacing  spaces  with  tabs  whenever  possible,  but  only  if  there  are  at  least  three 
of  them  so  as  not  to  o«-  me  ends  of  sentences,  flic  visual  appearance  of  the  text  should  never  be  changed  by 
Tabify  or  Untabify. 


1 1.3.1.  Till)  Stops 

For  typing  in  tables,  you  can  use  Text  mouc's  definition  of  Tab.  ~R  Tab  to  lab  Stop,  which  may  be  given 
anywhere  in  a  line,  and  indents  from  there  to  the  next  tab  stop.  If  you  are  not  in  Text  mode,  this  function  can 
be  found  on  M-l  anyway. 

Set  the  tab  slops  using  lid  it  Tab  Slops,  which  displays  for  you  a  buffer  whose  contents  define  the  tab  stops 
flic  first  line  contains  a  colon  or  period  at  cacli  tab  stop.  Colon  indicates  an  ordinary  lab.  which  fills  with 
whitespace:  a  period  specifics  that  characters  be  copied  from  the  corresponding  columns  of  the  second  line 
below  it.  Iluis,  you  can  lab  to  a  column  automatically  inserting  dashes  or  periods,  etc.  It  is  your 
responsibility  to  put  in  the  second  line  the  text  to  he  copied,  ’lire  third  and  fourth  lines  you  see  contain 
column  numbers  to  help  you  edit.  Ibey  arc  only  there  while  you  arc  editing  the  lab  stops:  they  arc  not  really 
part  of  the  tab  settings.  Ihe  first  two  lines  reside  in  the  variable  Tab  Stop  Definitions  when  they  are  not  being 
edited.  If  the  second  line  is  not  needed.  Tab  Stop  Definitions  can  be  just  one  line,  will)  no  CRI.I's.  Iliis 
makes  it  easier  to  set  the  variable  in  a  local  modes  list.  See  section  22.6  (Locals],  page  1 18. 


11.4.  Text  Filling 


Space  in  Auto  Till  mode,  breaks  lines  when  appropriate. 
M-Q  1-111  paragraph. 

M-G  111!  region  (G  is  for  Grind,  by  analogy  with  I  .isp). 
M-S  Center  a  line. 

C-X  =  Show  curt  cut  cursor  position. 
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HMACS  s  Amo  Mil  mode  lets  you  type  in  text  that  is  filled  (broken  up  into  lines  that  fit  in  ;r  specified 
width)  as  you  go.  if  you  alter  existing  text  and  thus  cause  it  to  cease  to  be  properiy  filled,  HMACS  can  fill  it 
again  if  you  ask. 

Hntering  Auto  Mil  mode  is  done  with  M-X  Auto  Fill.  From  then  on.  lines  arc  broken  automatically  at 
spaces  when  they  get  longer  than  the  desired  width.  New  lines  arc  usually  indented,  but  .:n  Text  mode  they 
arc  not.  To  leave  Auto  Mil  mode,  execute  M-X  Auto  Mil  again. 

When  you  finish  a  paragraph,  you  can  type  Space  with  an  argument  of  zero.  This  doesn't  insert  any 
spaces,  but  it  docs  move  the  hist  word  of  the  paragraph  to  a  new  line  if  it  di.-esn't  fit  in  the  old  line.  Return 
also  moves  the  last  word,  but  it  creates  another  blank  line. 

If  you  edit  the  middle  of  a  paragraph,  it  may  no  longer  be  correctly  filled.  To  re-fill  a  paragraph,  use  the 
command  Mela-Q  (~R  Mil  Paragraph).  It  causes  the  paragraph  dial  point  is  inside,  or  the  one  after  point  if 
point  is  between  paragraphs,  to  be  ic-filled.  All  the  line-breaks  arc  removed,  and  then  new  ones  are  inserted 
where  na-cssary. 

If  you  arc  not  happy  will;  Meta-Q's  idea  of  where  paragraphs  start  and  end  (the  same  as  Mcia-H's.  See 
section  1 1.2  (Paragraphs!,  page -14.).  you  can  use  Mcla-G  CR  Mil  Region)  which  re-fills  everything  between 
point  and  mark.  Sometimes,  it  is  ok  to  (ill  a  region  of  several  paragraphs  at  once.  Meta  Ci  recognizes  a  blank 
line  or  an  indented  line  as  starting  a  paragraph  and  not  111!  it  in  with  the  preceding  line.  The  sequence 
space-backspace  at  the  front  of  a  line  will  prevent  it  from  being  filled  into  the  preceding  line  but  is  invisible 
when  the  file  is  printed.  However,  the  full  sophistication  of  the  paragraph  commands  in  recognizing 
paragraph  boundaries  is  not  a.ailablc.  "Hie  purpose  of  M-G  is  to  allow  you  to  oveiride  HMACS’s  usual 
criteria  for  paragraph  boundaries. 

Giving  an  argument  to  M-G  or  M-Q  causes  die  text  to  be  justified  instead  of  filled.  This  means  dial  extra 
spaces  arc-  inserted  between  the  words  so  as  to  make  the  right  margin  come  out  exactly  even.  I  do  not 
recommend  doing  this.  If  someone  else  lias  uglified  some  text  by  justifying  it.  you  can  unjustify  it  (remove 
die  spaces)  with  M-G  or  M-Q  without  an  argument. 

‘Hie  command  Meta-S  (~R  Center  I  .inc)  centers  a  line  within  the  current  line  w  idtli.  With  an  argument,  it 
centers  several  lines  individually  and  moves  past  them. 

'11k-  maximum  line  widdi  Hu  fiiiing  is  in  the  variable  Mil  Column.  Roth  M-Q  and  Auto  Fill  make  sure  that 
mi  line  exceeds  this  width  "Hie  easiest  way  to  set  the  variable  is  to  use  the  command  C-X  I-  CR  Set  Fill 
Column)  which  places  the  margin  at  the  column  point  is  on,  or  wherever  you  specify  with  a  numeric 
argument.  The  fill  column  is  initially  column  70. 

To  fill  a  paragraph  in  which  each  line  starts  with  «i  special  marker  (which  might  be  a  few  spaces,  giving  an 
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indented  paragiaph).  use  the  Fill  helix  fcatuic.  Move  the  cuisor  to  a  spot  right  after  the  special  marker  and 
give  the  command  C-X  .  (AR  Set  Fill  Prefix).  Then,  filling  the  paragraph  will  remove  the  marker  from  each 
line  beforehand,  and  put  (he  marker  back  in  on  each  line  aftciward.  Auto  Fill  when  there  is  a  fill  prefix  will 
insert  the  lill  picfix  at  the  front  of  each  new  line.  Also,  any  line  which  docs  not  start  with  the  fill  prefix  will  be 
considered  to  start  a  paragraph.  To  turn  off  the  fill  prefix,  do  C-X  .  with  the  cursor  at  the  front  of  a  line. 

Hie  \aiiablc  Space  Indent  Flag  controls  whether  Auto  Fill  mode  indents  the  new  lines  that  it  creates.  A 
nonzero  value  means  that  indentation  should  be  done. 

I'he  command  C-X  =  (What  Cursor  Position)  can  be  used  to  find  out  the  column  that  the  cursor  is  in,  and 
othei  miscellaneous  inhumation  about  the  cursor  which  is  quick  to  compute.  It  piints  a  line  in  the  echo  area 
thiil  looks  like  this: 

X  =  5  Y=- 7  CH=  10 1  .  =3874(3f)X  of  11014)  H^<305 1 , 4640> 

In  this  line,  the  X  value  is  the  column  the  cursoi  is  in  (zero  at  the  left),  the  V  value  is  the  screen  line  that  the 
cursor  is  in  (z.eio  at  the  top),  the  Cl  I  value  is  the  octal  value  of  the  character  aftei  the  uiisoi  ( 101  is  "A"),  the 
point  value  is  the  nuinbei  of  chaiacleis  in  the  buffet  before  the  cursor,  and  the  values  in  parentheses  are  the 
parentage  of  the  buffer  before  the  cuisor  and  the  total  size  of  the  buffer. 

The  II  values  arc  the  viilual  buffci  boundaiics,  indicate  which  pail  of  the  buffer  is  still  visible  when 
nuriowing  has  been  done.  If  you  have  not  done  nanowing,  the  II  values  arc  omitted.  Foi  more  information 
about  the  virtual  buffer  boundaries.  See  section  17  [Narrowing],  page 77. 

1 1 .5.  ('use  Conversion  Commands 

KM  ACS  has  commands  for  converting  either  a  single  word  oi  any  ai  library  range  of  text  to  upper  ease  or 
to  lower  ease. 

M-I.  Convert  following  word  to  lower  ease. 

M-U  Convert  following  word  to  uppercase. 

M-C  Capitalize  the  following  word. 

C-X  C-I .  Convert  region  to  lower  ease. 

C-X  C-U  Convert  region  to  upper  case. 

Tile  word  conversion  commands  arc  the  most  useful.  Mcta-I.  (AR  Lowercase  Word)  converts  the  word 
after  point  to  lower  case,  moving  past  it.  Thus,  successive  Mela-I.’s  convert  successive  winds.  Meta-ll 
('R  Uppercase  Wind)  conveits  to  all  capitals  instead,  while  Mela-C  (AR  Uppercase  Initial)  puts  the  first 
Icttci  of  the  wind  into  uppei  case  and  the  rest  i.ilolovvei  case.  All  these  commands  convert  several  words  at 
once  if  given  an  aigument.  They  aie  especially  convenient  for  convening  a  large  amount  of  text  from  all 
upper  case  to  mixed  case,  because  you  can  move  ihmugh  the  text  using  M  l.,  M-U  oi  M-C  on  each  word  as 
appropriate. 
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When  given  a  negative  argument,  the  word  ease  conversion  commands  apply  to  the  appropiiatc  number  of 
words  before  point,  but  do  not  move  point.  This  is  convenient  when  you  have  just  typed  a  woid  in  the  wrong 
ease.  You  can  give  the  ease  conversion  command  and  continue  typing. 

If  a  word  ease  conversion  command  is  given  in  the  middle  of  a  word,  it  applies  only  to  the  part  of  the  word 
which  follows  the  cursor,  treating  it  as  a  whole  word. 

The  other  ease  conversion  commands  arc  C-X  C-U  (AR  Uppercase  Region)  and  C-X  C-l  (AR  Lowercase 
Region),  which  convert  cvci\ thing  between  point  and  mark  to  the  specified  case.  Point  and  mark  do  not 
move.  These  commands  ask  for  confirmation  if  the  region  contains  more  than  Region  Query  Si/.e  characters; 
the>  also  save  the  oiiginal  contents  of  the  region  so  you  can  undo  them  (See  section  24.3  (Undo),  page  132.). 

11.6.  Font-Changing 

I  MACS  has  commands  to  insert  and  move  font  change  commands  .is  tindeistood  by  the  TJ6  and  R  text 
just i tiers.  A  font  change  is  assumed  to  he  of  the  form  t|’<digil>  meaning  select  the  specified  font,  or  tl;* 
meaning  select  the  previously  selected  font. 

M-  it  Change  previous  word’s  font,  or  next  word’s. 

C-X  tt  Change  font  of  region. 

M-#  is  a  command  to  change  the  font  of  a  word.  Its  action  is  rather  complicated  to  dcsciibe,  but  that  is 
because  it  n  ics  to  be  as  versatile  and  convenient  as  possible  in  practice. 

If  you  type  M -it  with  an  argument,  the  previous  word  is  pul  into  the  font  specified  by  the  argument. 
Point  is  not  changed.  This  means  that,  if  you  want  n  ’  'sen  a  word  and  put  it  in  a  specific  font,  you  can  type 
the  woid.  then  use  M-#  to  change  its  font,  and  then  go  on  inserting.  The  font  is  changed  by  putting  a 
iT’<digil>  before  the  word  and  a  tT*  after. 

If  you  type  M-#  with  no  argument,  it  takes  the  last  foiU  change  (either  a  tp'<digit>  or  tl-'*,  whichever  is 
later)  and  moves  it  one  word  forwnid.  What  this  implies  is  that  you  can  change  the  font  of  several  consecutive 
vvoids  incicmcnlnlly  by  moving  after  the  first  word,  issuing  M -it  with  an  argument  to  set  that  word's  font, 
and  then  typing  M-#  to  extend  the  font  change  past  more  words.  Hach  M -it  advances  past  one  more  word. 

M-//  with  a  negative  argument  is  the  opposite  of  M-#  with  no  aigumcnt;  it  moves  the  last  font  change 
Imh  one  woid.  If  you  type  mo  many  M-#'s,  you  can  undo  them  this  way.  If  you  move  one  font  change  past 
anolhei,  one  oi  both  ate  eliminated,  so  as  to  do  the  light  thing.  A,s  a  result,  M-Mimis  M-ft  will  undo  a  M-it 
with  an  argument.  Try  it! 

You  can  also  change  the  font  of  a  whole  legion  by  putting  point  and  the  mark  aiound  it  and  issuing  C-X 
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ft ,  wiih  she  font  numbei  as  argument.  C-X  tt  with  a  negative  argument  removes  all  font  changes  inside  or 
adjacent  to  the  region. 

11.7.  Underlining 

MACS  has  two  commands  for  manipulating  lext-justilicr  undo  lining  command  characters.  These 
commands  do  not  pioducc  any  suit  of  overprinting  in  the  text  file  itself;  they  insert  or  move  command 
chaiaclci .  which  direct  text  justifieis  to  produce  tmdeilining.  By  default,  commands  for  the  text  justificr  R 
arc  used. 

M-_  Underline  previous  word  or  next  word. 

C-X  _  Underline  region. 

M-_  is  somewhat  like  M-  tt  in  that  it  either  denies  an  underline  around  the  pieviotis  word  or  extends  it 
past  the  next  word.  Ilovvovci.  where  a  font  change  i etjtiires  th.it  you  specify  a  font  number,  an  undciline  is 
just  an  undeilmc  and  has  no  parameiei  for  you  to  specify.  Also,  it  is  assumed  that  the  text  justilicr's 
commands  Ibi  stalling  and  ending  uiulci lines  ate  distinguishable,  whereas  you  can't  tell  liom  a  font  change 
whether  it  is  "starting"  something  or  "ending"  something.  M-_  differs  slightly  from  M-tt  as  a  result. 

M-_  with  no  argument  cieates  an  undciline  around  the  previous  word  if  there  is  none.  If  thcic  is  an 
undciline  there,  it  is  extended  one  word  forward.  ’Ilius,  you  can  mscit  an  umlci lined  word  by  typing  the 
wind  and  then  a  M-_.  Or  you  can  undciline  several  existing  words  by  moving  past  the  first  of  them,  and 
typing  one  M-_  for  each  word. 

M-_  given  in  the  vicinity  of  an  undcilinc-begin  moves  //forward.  Thus,  it  should  be  thought  of  as 
applying  to  any  boundaiy,  where  underlining  either  starts  or  stops,  and  moving  it  forward.  If  a  begin 
underlining  is  moved  past  an  end,  or  vice  versa,  they  both  disappear. 

Giv  ing  M-_  an  uigumcnl  merely  tells  it  to  apply  to  several  words  at  once  instead  of  one.  M-_  with  a 
positive  argument  of  n  underlines  the  next  n  words,  either  creating  an  underlined  area  or  extending  an 
existing  one.  With  a  negative  argument,  that  many  pievious  words  are  underlined.  Thus,  N1-_  can  do  more 
things  vv  ith  undci  lines  than  M-  tt  can  do  with  font  changes,  because  of  the  facts  that  you  don't  need  to  use  the 
argument  to  say  which  font,  and  you  can  tell  a  beginning  from  an  end. 

For  huger  scale  operations,  you  can  use  C-X  _  to  place  underlines  from  poi.it  to  mark,  or  C-X  _  with  a 
negative  aigumcnt  to  remove  alt  underlining  between  point  and  mark. 

By  default,  tB  is  used  to  begin  an  underline  and  tF.  is  used  to  end  one.  The  variables  Underline  Begin  and 
Underline  F.nd  may  be  created  and  set  to  strings  to  use  instead.  For  a  single  character  you  can  use  the 
numeric  ASCII  code  for  it. 
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12.  Commands  for  Fixing  Typos 


In  this  section  we  describe  (he  commands  that  are  especially  useful  for  (lie  times  when  you  catch  a  mistake 
in  your  text  just  after  you  have  made  it.  or  change  your  mind  when  writing  something  on  line. 


Rubout 

Delete  last  character. 

M-Rubout 

Kill  last  word. 

C-X  Rubout 

Kill  to  beginning  of  sentence. 

C-T 

Transposes  two  characters. 

C-X  C-T 

Transposes  tsvo  lines. 

C-X  T 

Transposes  two  arbitrary  regions. 

M-Minus  M-l. 

Convert  last  word  to  lower  case. 

M-Minus  M-U 

Convert  last  word  to  all  uppercase. 

M-Minus  M-C 

Convert  last  word  to  lowercase  with  capital  initial. 

M-’ 

l-’ix  up  omitted  shift  key  on  digit. 

1 2. 1.  Killing  Your  Mislakcs 

The  Rubout  command  is  the  most  important  correction  command.  When  used  among  printing 
(self-inserting)  characters,  it  can  be  thought  of  as  canceling  the  last  character  typed. 

When  your  mistake  is  longer  than  a  couple  of  characters,  it  might  be  more  convenient  to  use  M-Rubout  or 
C-X  Rubout.  M-Rubout  kills  back  to  the  start  of  the  last  word,  and  C-X  Rubout  kills  back  to  the  start  of  the 
last  sentence.  C-X  Rubout  is  particularly  useful  when  you  are  thinking  of  what  to  wiitc  as  you  type  it,  in  case 
you  change  your  mind  about  phrasing.  M-Rubout  and  C'-X  Rubout  save  the  killed  text  for  C-Y  and  M-Y  to 
retrieve  (Sec  section  9.2  [Un-killing],  page  37.). 

M-Rubout  is  often  useful  even  when  you  have  typed  only  a  few  characters  wrong,  if  you  know  you  arc 
confused  in  your  typing  and  aren’t  sure  exactly  what  you  typed.  At  such  a  time,  you  cannot  correct  with 
Rubout  except  by  looking  at  the  screen  to  sec  what  you  did.  It  requires  less  thought  to  kill  the  whole  word 
and  start  over  again,  especially  if  the  system  is  heavily  loaded. 

12.2.  Transposition 

The  common  error  of  transposing  two  characters  can  be  fixed,  when  they  arc  adjacent,  with  the  C-T 
command.  Normally,  C-T  transposes  the  two  characters  on  cither  side  of  the  cursor.  When  given  at  the  end 
of  a  line,  rather  than  transposing  the  last  character  of  the  line  with  the  line  separator,  which  would  be  useless, 
C-T  transposes  the  last  two  characters  on  the  line.  So,  if  you  catch  your  transposition  error  right  away,  you 
can  fix  it  with  just  a  C-T.  If  you  don't  catch  it  so  fast,  you  must  move  the  cursor  back  to  between  the  two 
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transposed  characters.  If  you  tiansposeda  space  with  the  last  character  of  the  word  bcfoic  it.  the  word  motion 
commands  arc  a  good  way  of  getting  there.  Otherwise,  a  reverse  search  (OR)  is  often  the  best  way.  Sec 
section  10  [Search],  page  41. 

To  transpose  two  lines,  use  the  OX  OT  command  (~R  Transpose  Lines).  M-T  transposes  words  and 
OM-T  transposes  s-expressions. 

A  mote  general  transpose  command  is  OX  T  OR  Transpose  Regions).  This  transposes  two  aibitrary 
blocks  of  text,  which  need  not  even  be  next  to  each  other.  To  use  it.  set  the  mark  at  one  end  of  one  block, 
then  at  the  other  end  of  the  block;  (hen  go  to  the  other  block  and  set  the  mark  at  one  end,  and  put  point  at  the 
other.  In  other  words,  point  and  the  last  three  marks  should  be  at  the  four  locations  which  are  the  ends  of  the 
two  blocks.  It  docs  not  matter  which  of  the  four  locations  point  is  at,  or  which  order  the  others  were  marked. 
C-X  T  transposes  the  two  blocks  of  text  thus  identified,  and  relocates  point  and  the  (luce  maiks  without 
changing  their  order. 

12.3.  Case  Conversion 

A  veiv  common  error  is  to  type  words  in  the  wrong  case.  Because  of  this,  the  word  case-conversion 
commands  M-L,  M-U  and  M-C  have  a  special  feature  when  used  with  a  negative  argument:  they  do  not 
move  the  cursor.  As  soon  as  you  see  you  have  mistyped  the  last  word,  you  can  simply  case-convert  it  and  go 
on  typing.  See  section  1 1.5  [Case],  page  49. 

Another  common  error  is  to  type  a  special  character  and  miss  the  shift  key,  producing  a  digit  instead. 
There  is  a  special  command  for  fixing  this:  M-’  (-'ll  Upcase  Digit),  which  fixes  the  last  digit  before  point  in 
this  way  (but  only  if  that  digit  appears  on  the  current  line  or  the  previous  line.  Otherwise,  to  minimize 
random  effects  of  accidental  use,  M-’  docs  nothing).  Once  again,  the  cursor  docs  not  move,  so  you  can  use 
M-'  when  you  notice  the  error  and  immediately  continue  typing.  Because  M-’  needs  to  know  the 
arrangement  of  your  keyboard,  the  fiist  time  you  use  it  you  must  supply  the  information  by  typing  the  row  of 
digits  1, 2. ..  ,  9, 0  but  holding  down  the  shift  key.  This  tells  NT’  the  correspondence  between  digits  and  special 
characters,  which  is  icmcmbcrcd  for  the  duration  of  the  LMACS.  This  command  is  called  M-’  because  its 
main  use  is  to  replace  "7"  with  a  single-quote. 


C-X  C-V  Visit  a  file. 

C-X  C-R  Visit  a  file  for  reading  only. 

C-X  C-S  Save  the  \isitcd  file. 

Meta—  fell  I -MACS  to  forget  that  the  buffet  lias  been  changed. 

Visiting  ;t  file  means  copying  its  contents  into  CM  ACS  where  you  can  edit  litem.  HMACS  remembers  the 
name  of  the  file  you  visited.  Unless  you  use  the  multiple  buffer  and  window  features  of  HMACS.  you  can 
only  be  visiting  one  file  at  a  time.  The  name  of  the  file  you  arc  visiting  in  the  cmreully  selected  buffer  is 
visible  in  the  mode  line  when  you  arc  at  top  level. 

The  changes  you  make  with  liMACS  to  the  text  of  the  file  you  .ire  visiting  ate  made  not  in  the  file  itself, 
hut  in  a  copy  inside  liMACS.  The  file  itself  is  not  changed.  The  changed  text  is  not  permanent  until  you  save 
it  in  a  file.  The  first  lime  you  change  the  text,  a  star  appeals  at  the  end  of  the  mode  line:  this  indicates  that  the 
text  contains  liesh  changes  which  will  be  lost  unless  you  stive  them.  You  can  do  that  til  any  time  with  C-X 
C-S.  If  you  change  one  file  and  then  try  to  visit  another  in  the  same  buffer,  liMACS  offers  to  save  the  first 
file  (if  it  is  not  saved,  the  changes  are  lost).  In  addition,  for  those  who  tire  afraid  of  system  crashes.  Auto  Save 
mode  saves  the  file  tit  regular  intervals  automatically  while  you  edit.  See  section  13.3  [Auto  Stive],  page  57. 
Journal  files  arc  another  way  of  piotccling  against  crashes.  See  section  24.4  (Journals],  page  133. 

To  visit  a  file,  use  the  command  C-X  C-V  ("it  Visit  File).  Follow  the  command  with  the  name  of  the  file 
you  wish  to  visit,  terminated  by  a  Return.  If  you  can  sec  a  filename  in  the  mode  line,  then  that  name  is  the 
default,  and  any  component  of  the  filename  which  you  don't  specify  is  taken  from  them.  If  liMACS  thinks 
you  can’t  see  the  defaults,  they  are  included  in  (he  prompt.  You  can  aboil  the  command  by  typing  C-G,  or 
edit  the  filename  with  Ruboul  and  C-U.  If  you  do  type  a  Return  to  finish  the  command,  the  new  file’s  text 
appeals  on  the  screen,  and  its  name  shows  up  in  the  mode  iinc. 

When  yot!  wisli  to  stive  the  file  and  make  your  changes  pcimancnt,  type  C-X  C-S  ("R  Save  File).  After 
the  stive  is  finished,  C-X  C-S  piints  "Written:  <filcnamc.s>"  in  the  echo  area  at  the  bottom  of  the  screen.  If 
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you  arc  visiting  a  file  whose  name  is  this  message  contains  the  version  number  actually  written.  If  there 
are  no  changes  to  save,  the  file  is  not  saved:  it  would  be  redundant  to  save  a  duplicate  of  the  previous  version. 

However,  you  need  not  do  the  saves  yourself.  If  you  alter  one  file  and  then  visit  another,  l-MACS  may 
offer  to  save  the  old  one.  If  you  answci  Y,  the  old  file  is  saved;  if  you  answer  N,  all  the  changes  you  have 
made  to  it  since  the  last  save  arc  lost.  You  should  not  type  ahead  after  a  file  visiting  command,  because  your 
type-ahead  might  answer  an  unexpected  question  in  a  way  that  you  would  regret.  If  you  are  sure  you  only 
want  to  look  at  a  file,  and  not  change  it,  you  can  use  die  C-X  C-R  command  to  visit  it,  instead  of  C-X  C-V.  If 
a  file  was  visited  with  C-X  C-R,  HMACS  docs  not  offer  to  stive  it  when  you  visit  the  next  file.  It  assumes  the 
changes  were  inadvertent.  However,  you  can  still  save  the  file  with  C-X  C-S. 

If  l-MACS  is  about  to  stive  a  file  automatically  and  discovers  that  the  text  is  now  a  lot  shorter  than  it  used 
to  be.  it  tells  you  so  and  asks  foi  confirmation  (Y  or  N).  If  you  aien'l  sure  what  to  answer  (because  you  arc 
•an  prised  that  it  has  shrunk),  type  C-G  to  abort  everything,  and  take  a  look  at  your  buffer. 

Sometimes  you  will  change  a  buffer  by  accident,  liven  if  you  undo  the  change  (perhaps,  tub  out  the 
character  you  inserted).  l-MACS  still  knows  that  "the  bull'er  has  been  changed".  You  can  tell  liMACS  to 
forget  about  that  with  the  Mela—  (AR  Duller  Not  Modified)  command.  This  command  simply  clears  the 
"modified"  llag  which  says  that  the  buffer  contains  changes  which  need  to  be  saved.  It  is  up  to  you  not  to  use 
it  unwisely.  If  we  take"  tomcat)  "not",  then  Meta —  is  "not"  metalled. 

What  if  you  want  to  v.reale  a  file?  Just  visit  it.  l-MACS  print  "(New  File)"  but  otherwise  acts  unworried. 
If  you  make  any  changes  and  save  them,  the  file  is  created.  If  you  visit  a  nonexistent  file  unintentionally 
(because  you  typed  the  wrong  file  name),  visit  the  file  you  meant.  If  you  didn’t  "change"  the  nonexistent  file 
(you  never  inserted  anything  in  it),  it  is  not  created. 

If)- MACS  is  about  to  save  a  file  and  sees  that  the  latest  version  on  disk  is  not  the  same  one  as  liMACS  last 
read  or  wrote,  l-MACS  notifies  you  of  this  Diet,  and  asks  what  to  do,  because  this  probably  means  that 
something  is  wrong.  For  example,  someone  else  may  have  been  editing  the  same  file.  If  this  is  so,  there  is  a 
good  chance  that  your  work  or  his  work  will  be  lost  if  you  don’t  take  the  proper  steps.  You  should  first  find 
out  exactly  wlutl  is  going  on.  The  C-X  C  l)  command  to  list  the  directory  will  help.  If  you  dctciminc  that 
someone  else  has  modified  the  file,  save  your  file  under  different  names  (or  at  least  making  a  new  version) 
and  then  SRCCOM  the  two  files  to  merge  the  two  sets  of  changes.  Also  get  in  touch  with  the  other  person  so 
that  he  doesn’t  continue  editing. 
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13.2.  How  to  Undo  Drastic  Changes  to  a  File 

If  you  have  made  extensive  changes  to  a  file  and  then  change  your  mind  about  them,  you  can  get  rid  of 
them  by  reading  in  the  previous  version  of  the  file.  To  do  this,  use  M-X  Revert  l-'ilc.  If  you  have  been  using 
Auto  Save  mode,  it  reads  in  the  last  version  of  the  visited  file  or  the  last  auto  save  file,  whichever  is  more 
recent. 

If  you  are  using  Auto  Save  mode,  saving  as  special  Auto  Save  filenames,  then  you  can  ask  to  reveit  to  the 
last  "real"  save,  ignoring  subsequent  auto  saves,  with  C-U  M  X  Revert  File.  If  you  arc  using  the  style  of  aum 
saving  which  saves  under  the  real  filenames,  this  is  not  possible. 

M-X  Reveit  l-'ilc  d  ies  not  change  point,  so  that  if  the  file  was  only  edited  slightly,  you  will  be  at 
approximately  the  same  piece  of  text  after  the  Reveit  as  before.  If  you  have  made  drastic  changes,  the  same 
value  of  point  in  the  old  file  may  address  a  totally  different  piece  of  text. 

because  M-X  Revert  File  can  be  a  disaster  if  done  by  mistake,  it  asks  for  confumation  (V  or  N)  before 
doing  its  work.  A  pre-comma  argument  can  be  used  to  inhibit  the  request  for  confirmation  when  you  call  the 
function  Reveit  File  from  aTI-CO  piogram,  as  in  l,M(M.M  Revcil_F’ile$). 


13.3.  Auto  Save  Mode:  Protect  ion  Against  Crashes 

If  you  turn  on  Auto  Save  mode.  IvMACS  saves  your  file  from  time  to  time  (based  on  counting  your 
commands)  w  iihnul  being  asked.  Your  file  is  also  saved  if  you  stop  typing  for  more  than  a  few  minutes  when 
there  aie  changes  in  the  buffer.  This  prevents  you  from  losing  more  than  a  limited  amount  of  work  when  die 
system  crashes.  (Another  method  of  protection  against  crashes  is  the  journal  file.  See  section  24.4  [Journals), 
page  133.).  You  can  turn  auto  saving  on  or  off  in  an  individual  buffer  with  M-X  Auto  Save.  In  addition,  you 
can  have  auto  saving  by  default  in  all  buffers  by  setting  the  option  Auto  Save  Default.  The  frequency  of 
saving,  and  the  number  of  saved  versions  to  keep,  can  both  be  specified. 

I vach  time  you  visit  a  file,  no  matter  how,  auto  saving  will  be  on  for  that  file  if  Auto  Save  Default  is 
non  zero.  I  lowevcr,  by  giving  a  nonzero  argument  to  the  file-visiting  command,  you  can  turn  off  auto  saving 
for  ilwl  file  only,  without  changing  the  default.  For  example,  you  might  use  C-U  C-X  C-V  to  do  this.  Once 
you  have  visited  a  file,  you  can  mm  auto  saving  on  or  off  with  M-X  Auto  Save.  I  ike  other  minor  mode 
commands.  M-X  Auto  Save  turns  the  mode  on  with  a  positive  argument,  off  with  a  zero  or  negative 
argument;  with  no  argument,  it  toggles.  If  you  stall  typing  a  new  file  into  a  buffer  without  visiting  anything, 
auto  save  mode  is  initially  off,  but  you  can  turn  it  on  with  M-X  Auto  Save. 

When  an  auto  save  happens.  "(Auto  Save)”  is  printed  in  the  echo  area  (On  a  printing  tciminal,  the  bell  is 
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rung  instead).  An  ciror  in  the  process  of  auto  saving  prints  "(Auto  Save  Hrror!)". 

I  .ct  us  suppose  that  it  is  time  for  an  automatic  save  to  be  done:  where  should  the  file  be  saved? 

Two  workable  methods  have  been  developed:  save  the  file  under  the  names  you  have  visited,  or  save  it 
under  some  special  "auto  save  file  name".  liach  solution  has  its  good  and  bad  points.  The  first  one  is 
cxcelle.it  some  of  the  time,  but  intolerable  the  rest  of  the  lime.  'Hie  second  is  usually  acceptable.  Auto  saving 
under  the  visited  file’s  actual  names  means  that  you  need  do  nothing  special  to  gobble  the  auto  save  file  when 
you  need  it:  and  it  means  that  there  is  no  need  to  worry  about  interference  between  two  users  sharing  a 
directory,  as  long  as  they  aren't  editing  the  same  file  at  once.  However,  this  method  can  sometimes  have 
problems: 

If  you  visit  a  file  on  a  device  other  than  DSK.  auto  saves  can't  go  there,  because  it  would 
probably  be  slow. 

if \oiir  file  docs  not  have  a  numeric  version  number,  or  yon  have  visited  a  fixed  version,  auto 
saves  can't  go  under  that  name,  because  they  would  elobher  the  original  file. 

If  you  visit  a  file  with  C-X  C-K,  then  you  have  said  you  don't  want  to  store  under  those  names. 

if  you  hincn't  visited  a  file,  there  aren’t  any  names  to  use. 

In  all  these  cases,  the  filenames  for  auto  saving  are  taken  from  the  variable  Auto  Save  l-'ilcnamcs.  If  none  of 
those  cases  apply  then  it  is  possible  to  stoic  auto  saxes  under  the  visited  name.  Ibis  will  be  done,  proxided 
that  uni  uun  on  the  feature  by  setting  the  variable  Auto  Saxe  Visited  File  to  a  non/ero  value. 

When  you  want  to  save  your  file  "for  real",  use  C'-X  C-S,  as  always.  C-U  C'-X  C-S  is  a  way  to  request  an 
"auto"  save  explicitly.  When  you  are  auto  saxing  under  the  visited  filenames,  there  is  not  much  difference 
between  an  auto  save  and  a  "real"  save,  except  that  an  auto  saxc  will  eventually  be  deleted  automatically  by 
1-MACS  a  few  auto  saves  Inter,  while  a  "real"  save  will  be  left  around  forever  (at  least,  auto  save  won’t  delete 
it). 

When  it  is  time  to  recover  from  a  system  crash  by  reloading  the  auto  stive  file,  if  auto  saving  was  using  the 
visited  file  names  you  have  nothing  special  to  do.  If  auto  saving  was  using  special  auto  stive  filenames,  read  in 
the  last  auto  save  file  and  then  use  C-X  C-W  (Write  File)  to  write  it  out  in  its  real  location.  If  you  want  to  use 
tin  auto  save  file  to  throw  away  changes  that  you  don't  like,  you  etui  use  M-X  Rcxcri  l-'ile,  which  knows  how 
to  find  the  most  recent  save.  peiiuanetU  or  not,  under  whatever  filenames.  Sec  section  1.1.2  jRcverlJ,  page  57. 

For  your  piotcction.  if  a  file  litis  shrunk  by  more  than  .10%  since  the  last  sa  e,  auto  saving  does  not  save. 
Instead  it  prints  a  message  that  the  file  has  shrunk.  You  can  stive  explicitly  if  you  wish:  tiller  that,  auto  saving 
will  resume. 


Although  auto  saving  generates  huge  numbers  of  files,  it  does  not  clog  directories,  because  it  deans  up 
after  itself.  Only  the  last  Auto  Stive  Max  auto  save  files  are  kept;  as  further  stives  arc  done,  old  auto  saves  arc 
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deleted.  However,  files  which  were  not  made  by  auto  saving  (or  by  explicitly  requested  auto-saves  with  C  ll 
C-X  C-S)  arc  never  deleted  in  this  way.  'Hie  variable  Auto  Save  Max  is  initially  2.  Changing  the  value  may 
not  take  effect  in  a  given  buffer  until  you  turn  auto  saving  off  and  on  in  that  buffer. 

'Hie  number  of  characters  of  input  between  auto  saves  is  controlled  by  the  variable  Auto  Save  Interval.  It 
is  initially  500.  Changing  this  takes  effect  immediately. 

Auto  Save  Filenames  is  usually  set  up  by  the  default  init  file  to  DSKXworking  direclory>:_'‘RSV  >.  If 
you  use  auto  an  itig  in  multiple  buffers  a  lot,  you  might  want  to  have  a  Buffer  Creation  1  look  which  sets  Auto 
Sa\c  Filenames  to  a  filename  based  on  the  buffer  name,  so  that  different  buffers  don’t  interfere  with  each 
other. 


1.11.  Listing  a  File  Directory 

To  look  at  a  part  of  a  file  directory,  use  the  C-X  C-l)  command  (~R  Directory  Display).  With  no 
atgument,  it  shows  you  die  lile  you  aic  visiting,  and  related  files  with  the  same  fust  name.  C-U  C-X  C-l) 
reads  a  filename  from  the  terminal  and  shows  you  the  files  related  to  that  filename. 

To  see  (he  whole  directory  in  a  brief  format,  use  the  function  l.ist  Files,  which  takes  the  directory  name  as 
a  siring  argument.  Ihc  function  View  Directory  prints  a  verbose  listing  of  a  whole  directory. 

fin:  variable  Auto  Direcloiy  Display  can  be  set  to  make  many  file  opciations  disnlay  the  directory 
automatically.  The  variable  is  normally  0;  making  it  positive  causes  write  operations  such  as  Write  File  to 
display  the  directory,  and  making  it  negative  causes  read  operations  such  as  Insert  File  or  visiting  to  display  it 
as  well.  Ihe  displ:  y  is  done  using  die  default  directory  listing  function  which  is  kept  in  the  variable  Directory 
I.istcr.  Noimally.  in  KM  ACS.  this  is  the  function  that  displays  only  the  files  related  to  the  current  default 
file.  An  alternative  type  of  directory  listing  can  be  obtained  by  setting  Directory  I.istcr  to  M.M&  Rotated 
Directory  Listing^.  'Jliis  function  always  displays  the  whole  directory,  but  starts  with  the  file  you  arc 
interested  in,  proceeding  through  the  end  of  the  director)'  around  to  the  beginning. 


13.5.  Cleaning  a  File  Diredory 

The  normal  course  of  editing  constantly  creates  new  versions  of  files.  If  you  don’t  eventually  delete  (he  old 
versions.  Hie  directory  will  fill  up  and  further  editing  will  he  impossible.  FMACS  has  commands  that  make  it 
easy  to  delete  the  old  versions. 

For  complete  flexibility  to  delete  precisely  the  files  you  want  to  delete,  you  can  use  the  D1RFD  package. 
See  section  1.1.6  (DIRFDJ,  page  60,  for  more  details. 
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But  there  is  a  more  convenient  way  to  do  the  usual  thing:  keep  only  the  two  (or  other  number)  most 
recent  versions. 

M-X  Reap  FilcKfileXcr>  counts  the  number  of  versions  of  <file>.  If  there  arc  more  than  two,  you  are 
told  the  names  of  the  recent  ones  (to  be  kept)  and  the  names  of  the  older  ones  (to  be  deleted),  and  asked 
whether  to  do  the  deletion  (answer  V  or  N).  Files  which  have  the  "Don’t  Reap"  bit  set  arc  excluded;  they  are 
always  kept. 

Reap  File  makes  a  special  offer  to  delete  individual  files  whose  FN2  indicates  that  they  arc  likely  to  be 
temporary.  The  list  of  temporary  names  is  contained  in  a  TF.CO  search  string  in  the  variable  Temp  File  FN2 
I  ist.  See  section  19.3  (THCO  search  strings],  page  85. 

If  you  gi\c  M-X  Reap  File  a  null  filename  argument,  or  no  argument,  then  it  applies  to  the  file  you  arc 
visiting. 

M-X  Clean  DiiccloryKdirnamc>:  <cr>  cleans  a  whole  directory  of  old  versions.  Knelt  file  in  the  directory 
is  processed  a  la  M-X  Reap  File.  M-X  Clean  Dir  with  a  null  argument,  or  no  argument,  cleans  the  directory 
containing  the  file  you  arc  visiting. 

M-X  Reap  File  and  M-X  Clean  Dir  can  be  given  a  numeric  argument  which  specifics  how  many  versions 
to  keep.  For  example,  C-U  4  M-X  Reap  File  would  keep  the  four  most  recent  versions.  Iltc  default  when 
there  is  no  argument  is  the  value  of  the  vaiiable  File  Versions  Kept,  which  is  initially  2. 


13.6.  DIKED,  the  Directory  Editor  Subsystem 

I )!  R  FI )  makes  it  easy  to  delete  many  of  the  files  its single  directory  at  once.  It  presents  a  copy  of  a  listing 
of  the  directory,  which  you  can  mine  around  in,  marking  files  for  deletion.  When  you  arc  satisfied,  you  can 
tell  DIRFD  to  go  ahead  and  delete  the  marked  files. 

Invoke  D1RHD  with  M-X  DIRFD  to  edit  the  current  default  directory,  or  M-X  DIRFDKdir>;<cr>  to  edit 
directory  <dir>.  You  arc  then  given  a  listing  of  the  directory  which  you  can  move  around  in  with  all  the 
normal  FM  ACS  motion  commands.  Some  (-‘MACS  commands  are  made  illegal  and  others  do  special  things, 
hut  it's  still  a  recursive  editing  level  which  you  can  exit  normally  with  C-M-C  am!  abort  with  C-|. 

You  can  mark  a  file  for  deletion  by  moving  to  the  line  describing  the  lilc  and  typing  I),  OS),  K,  or  OK. 
The  deletion  maik  is  visible  as  a  I)  at  the  beginning  of  the  line.  Point  is  moved  to  the  beginning  of  the  next 
line,  so  that  several  Ds  delete  several  files.  Alternatively,  if  you  give  I)  an  argument  it  marks  that  many 
consecutive  files.  Given  a  negative  argument,  it  marks  the  preceding  file  (or  several  files)  ami  puts  point  at 
die  first  (in  the  buffer)  line  marked.  Most  of  the  DIRFD  commands  (l>,  U. !,  $,  i\  S,  C.  F,  Space)  repeat  this 
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way  will)  numeric  arguments. 

if  you  wish  to  remove  u  deletion  mark,  use  the  U  (for  Undelete)  command,  which  is  invoked  like  D:  it 
removes  the  deletion  mark  from  the  cm  rent  line  (or  next  few  lines,  if  given  an  argument).  Hie  Rubout 
command  removes  the  deletion  in.uk  from  the  previous  line,  moving  up  to  that  line..  Thus,  a  Rubout  after  a 
I)  precisely  cancels  the  D. 

For  extra  convenience.  Space  is  made  a  command  similar  to  C-N.  Moving  down  a  line  is  done  so  often  in 
DIRI-I)  that  it  deserves  to  be  easy  to  type.  Rubout  is  often  useful  simply  for  moving  up. 

if  you  arc  not  sure  whether  you  want  to  delete  a  Hie.  you  can  examine  it  by  typing  K.  Ibis  enters  a 
recursive  editing  mode  on  the  file,  which  you  can  exit  with  C-M-C.  The  fije  is  not  really  visited  at  that  time, 
and  you  are  not  allowed  to  change  it.  When  you  exit  the  recursive  editing  level,  yon  return  to  I  MR  Id).  I  lie  V 
command  is  like  K  but  uses  View  File  to  look  at  the  file. 

When  you  have  marked  the  files  you  wish  to  mark,  you  can  exit  DIRl-l)  wjih  C-M-C.  If  any  files  were 
marked  for  deletion.  DIRI-I )  lists  them  in  a  concise  fonn.it,  several  pci  line.  A  file  with  "!"  appearing  next  to 
it  in  this  list  has  not  been  saved  on  tape  and  will  he  gone  forever  if  deleted.  A  file  with  in  front  of  it  is  ihe 
most  recent  version  of  a  sequence  and  you  should  he  wary  of  deleting  it.  I  hen  DIRI-I)  asks  Ibrconfiim.ition 
of  the  list.  You  can  type  "YDS"  (Just  "Y"  won't  do)  logo  ahead  and  delete  them,  "N"  to  return  to  editing  the 
diicclory  so  you  can  change  the  mniks.  or  "X"  to  give  up  and  delete  nothing.  No  Return  diameter  is  needed. 
Anything  else-  typed  make-.  I  MR  I  I )  pi  ini  a  list  oflhe.se  i espouses  and  tiy  again  lo  lead  one  of  (hem. 


13.6.1.  Ollier  DIRK1)  Commands 

I  Ik  "!"  command  moves  down  (or  up.  with  an  argument  of  i)  to  tiie  next  undumped  file-  (one  with  a  "!" 
before  its  date). 

N  finds  the  next  "hog":  the  nc-xi  flic  which  basal  least  three  versions. 

T  when  given  on  a  line  describing  a  link  marks  for  deletion  the  file  which  the  link  points  to.  litis  file  need 
not  he  in  the  directory  you  arc  editing  lo  he  deleted  in  this  way. 

S  copies  tlic  file  you  arc  pointing  at  to  the  secondary  pack. 

i*  copies  the  file  you  are  pointing  at  to  the  primary  pack. 

Ji  complements  the  donTrcap  attribute  of  the  file;  this  is  displayed  as  a  dollar  sign  to  the  left  of  the  file 
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M  i novo  the  file  to  another  directory  or  device.  You  must  say  where  to  move  it 

C  runs  SRCCOM  to  compare  the  file  version  you  are  pointing  at  with  the  latest  version  of  the  same  file. 
You  must  confirm  the  SRCCOM  command  with  a  Return  before  it  is  executed:  you  can  add  extra  SRCCOM 
switches  before  the  Return.  When  you  return  to  KMACS.  the  cursor  moves  down  a  line  to  the  next  file. 

II  helps  you  clean  up.  It  marks  “old"  versions  of  the  current  file,  and  versions  with  "temporary”  second 
file  names,  for  deletion.  You  can  then  use  the  I)  and  11  commands  to  add  and  remove  marks  before  deleting 
the  files.  The  variables  File  Versions  Kept  and  Temp  Idle  1:N2  1  .ist  control  which  files  1 1  picks  for  deletion. 
With  an  argument  (C-U  H).  it  does  the  whole  directory'  instead  of  just  the  current  file. 

?  displays  a  list  of  the  DIRfil)  commands. 


1 3.6.2.  invoking  DIKED 

’lliere  arc  some  other  ways  to  invoke  DIRHI).  Ihc  Hmacs  command  C-X  I)  puts  you  in  DIRHI)  on  the 
directory  containing  the  file  you  are  cmrcntly  editing.  With  a  numeric  argument  of  1  (C-U  I  C-X  I)),  onlv 
the  current  file  is  displayed  instead  of  the  whole  directory.  In  combination  with  the  II  command  this  can  be 
useful  for  cleaning  up  excess  versions  (if  a  file  after  a  heavy  editing  session.  With  a  numeric  argument  of  4 
(C-U  C-X  D).  it  asks  you  "Directory;".  Type  a  directory  name  folio*  '*d  by  a  semicolon,  and/or  3  file  name. 
If  you  explicitly  specify  a  file  name  only  versions  of  that  file  arc  displayed,  otherwise  llic  whole  directory  is 
displayed. 

13.6.3.  Editing  the  DIKED  Buffer  Yourself 

it  is  unwise  to  try  to  edit  die  text  of  the  directory  listing  yourself,  without  using  die  special  DIRHI) 
commands,  unless  you  know  what  you  arc  doing,  since  you  can  confuse  DIRHI)  that  way.  To  make  it  less 
likely  that  you  will  do  so  accidentally,  the  self-inserting  characters  arc  all  made  illegal  inside  DIRHI). 
1  lowcvcr.  deleting  whole  lines  at  a  lime  is  certainly  safe,  This  docs  not  delete  the  files  described  by  those 
lines:  instead,  it  makes  DIRHD  forget  dint  they  arc  there  and  thus  makes  sure  they  will  not  be  deleted,  llurs. 
M-X  Keep  Lines*  is  useful  if  you  wish  to  delete  only  files  with  a  1*00  in  their  names.  Sec  section  19 
1  Replacement),  page  83. 

For  more  complicated  things,  you  can  use  the  miiiibulfcr.  When  you  call  the  minibufTcr  from  within 
DiKHI).  you  gel  a  perfectly  normal  one.  Die  special  DIR  HI)  commands  arc  not  present  while  you  arc  editing 
in  the  minibufTcr.  To  mark  a  file  for  deletion,  replace  the  space  at  the  beginning  of  its  line  with  a  "IF.  To 
remove  it  mark,  replace  the  "IF  with  a  space. 
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13.7.  Miscellaneous  File  Operations 

1-MAC’S  has  extended  commands  'or  performing  many  other  operations  on  files. 

M-X  View  File*  <file>  <cr>  allows  you  to  scan  or  read  a  file  by  sequential  screenful  without  visiting  the 
file.  It  enters  a  subsystem  in  which  you  type  a  Space  to  see  the  next  screenful  t.*  a  Backspace  to  sec  the 
previous  screenful.  Typing  anything  else  exits  «he  command.  View  File  docs  not  >isit  the  file;  it  does  not 
alter  the  contents  of  any  buffer.  The  advantage  of  View  File  is  that  the  whole  file  does  not  need  to  be  loaded 
before  you  can  begin  reading  it.  The  inability  to  do  anything  but  page  forward  or  backward  is  a  consequence. 

M-X  Write  File*  <filc>  <cr>  writes  the  contents  of  the  buffet  into  the  file  <lile>,  and  then  visits  that  file.  It 
can  be  thought  of  as  a  way  of  "changing  the  name"  of  the  file  you  are  visiting.  C-X  C-W  is  another  way  of 
getting  at  this  command. 

M-X  Insert  File*  <filc>  <cr>  inserts  the  contents  of  <lilc>  into  the  buffer  at  point,  leas  ing  point  unchanged 
before  the  contents  and  mark  after  them.  The  current  defaults  are  used  for  <lile>,  and  arc  updated. 

M-X  Write  Region*  <fi!e>  <o '  writes  the  region  (the  text  between  point  and  maik)  to  the  specified  file.  It 
docs  not  set  the  visited  filename...  The  buffer  is  not  changed. 

M-X  Append  to  File*  <filc>  <cr>  appends  the  region  to  <file>.  The  text  is  added  to  the  end  of  <filc>. 

M-X  Prepend  to  I'ilc*  <lile>  <cr>  adds  the  text  to  the  beginning  of<!tlc>  instead  of  the  end. 

M-X  Set  Visited  Filcname*<filcXcr>  changes  the  name  of  the  file  behig  visited  without  leading  or  writing 
the  data  in  the  buffer.  M-X  Write  File  is  equivalent  to  this  command  followed  by  a  C-X  C-S. 

M-X  l.ist  FilcsKdir  spccXcr>  lists  just  the  names  of  all  the  files  in  <dir>,  several  to  a  line. 

M-X  Delete  Filc*<fileXcr>  deletes  the  file. 

M-X  Copy  FilcKold  filc>*<ncw  fileXer)  copies  the  file. 

M-X  Rename  FilcKold  nainc>*<ncw  nameXcr>  renames  the  file. 

The  default  filenames  for  ail  of  these  operations  arc  the  "TI-CO  default  filenames".  Most  of  these 
operations  also  leave  the  TI-CO  default  names  -vt  to  the  file  they  operated  on.  The  TI-CO  default  is  not 
always  the  same  as  the  file  you  arc  visiting.  When  you  visit  a  file,  they  start  out  the  same;  the  commands 
mentioned  above  change  the  TI-CO  default,  but  do  not  change  the  visited  filenames.  Fach  buffer  has  its  own 
TFCO  default  filename0. 


The  opciation  of  visiting  a  file  is  available  as  a  function  under  the  name  M-X  Visit  Filc*<filc>*.  In  this 
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form,  it  uses  the  THCO  default  as  its  defaults,  though  it  still  sets  both  the  TKCO  default  and  the  visited 
filenames. 


13.8.  The  Directory  Comparison  Subsystem 

'Hie  function  Compare  Directories  makes  it  easy  to  compare  two  directories  to  see  which  files  arc  present 
in  both  and  which  arc  present  only  in  one.  It  compares  a  directory  on  the  local  machine  with  the  directory  of 
the  same  name  on  another  machine. 

Do  M-X  Compare  DircctoricsKmachinc>:<dir  spcc>  <switch>>,  where  <inachinc>  is  Al,  Ml.,  MC  or  DM, 
and  is  not  the  machine  you  arc  on.  <dir  spcc>  is  an  optional  directory  name  and  semicolon,  and  the  optional 
switch  is  a  slash  followed  by  S,  I)  or  L. 

After  a  while  of  crunching  vou  will  be  placed  in  a  recursive  editing  level  on  a  listing  of  both  dirceiorics. 
The  reason  for  the  recursive  *  ting  level  is  simply  to  make  it  easy  for  you  to  view  the  comparison;  unlike 
UIKHD,  Compare  Directories  does  not  have  any  commands  for  moving  or  deleting  the  files.  To  exit,  do 
O-M-C. 


I  lose  is  a  sample  of  part  of  a  directory  comparison: 

AI  RMS  #1=72  #2=78  #3=71  #4=77  #5=87  - 
MC  RMS  #0=231  #1=254  #13=2844 
AI  MC  .DDT.  ( INIT)  1  11/18/76  01:08 

AI  MC  L  . DDT*-  (INIT)  STAN. K  ML  EXIT 

MC  L  .TECO.  (INIT)  .TECO.  .TECO.  (INIT) 

AI  AR2  1  16  2/6/77  17:51 

AI  AR3  1  13  2/17/77  21:37 

AI  L  ATS  ORDER  .INFO.  8  ORDER 

MC  FTPU  4  9 

MC  FTPU  5  9 

AI  MC  MATCH  1  15  13/4/77  15:39 


10/21/76  05:06 


13/4/77 

13/4/77 

13/4/77 


16:46 

16:49 

15:39 


It  begins  with  one  line  for  each  of  the  two  directories,  these  lines  say  which  two  directories  they  are,  and 
how  much  disk  space  is  available  on  each  of  the  machines. 


Then  there  comes  the  list  of  files,  one  line  for  each  distinct  pair  of  filenames  that  appeals.  Al  the 
beginning  of  the  line  appear  the  names  of  the  machines  on  which  the  file  exisis.  At  the  end  of  the  line  come 
the  creation  dales  (or  names  pointed  at.  for  links)  of  the  file  for  the  machines  it  is  on.  Note  that  all  the 
dates/link  names  for  the  first  machine  line  up.  and  so  do  all  those  for  the  second  machine. 

'flic  switches  allow  you  to  view  only  some  of  the  files.  'Hie  /S  switch  shows  only  files  present  on  both 
machines.  /D  shows  only  those  not  present  on  both  machines.  /I.  shows  only  files  which  arc  the  most  recent 
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(largest-numbered)  of  a  sequence.  Only  one  switch  is  allowed. 
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14.  Using  Multiple  Buffers 


C-X  B  Select  or  create  a  buffer. 

C-X  C-F  Visit  a  file  in  a  new  buffer. 

C-X  C-B  I  ist  the  existing  buffers. 

C-XK  Kill  a  buffer. 

When  we  speak  of  "the  buffer",  which  contains  the  text  you  are  editing,  we  have  given  the  impression  that 
there  is  only  one.  In  fact,  there  may  be  many  of  them,  each  with  its  own  body  of  text.  At  any  time  only  one 
buffer  can  be  "selected"  and  available  for  editing,  but  it  isn’t  hard  to  switch  to  a  different  one.  Koch  buffer 
individually  remembers  which  file  it  is  visiting,  what  modes  are  in  effect,  and  whether  there  arc  any  changes 
that  need  saving. 

Kach  bulfct  in  KMACS  has  a  single  name,  which  normally  doesn't  change.  A  buffer's  name  can  be  any 
length.  The  name  of  the  currently  selected  buffer,  and  the  name  of  the  file  visited  in  it,  arc  visible  in  the 
mode  line  when  you  arc  at  top  level.  A  newly  started  KMACS  has  only  one  buffer,  named  "Main". 

As  well  as  the  v  isited  lilc  and  the  major  mode,  a  buffer  can,  if  ordered  to.  remember  many  other  things 
"locally",  which  means,  independently  of  all  other  buffers.  See  section  22.3  (Variables],  page  1 14. 

14.1.  Creating  and  Selecting  Buffers 

To  create  a  new  buffei,  you  need  only  think  of  a  name  for  it  (say.  ’TOO”!  and  then  do  C-X  B  K00<cr>, 
which  is  the  command  C-X  B  (Select  Buffer)  followed  by  the  name.  This  makes  a  new.  empty  buffer  and 
select  it  for  editing.  The  new  buffer  is  not  visiting  any  file,  so  if  you  try  to  save  it  you  will  be  asked  for  the 
filenames  to  use.  Kach  buffer  has  its  own  major  inode;  the  new  buffer's  major  mode  is  taken  from  the  value 
of  the  variable  Default  M.ijoi  Mode,  or  from  the  major  mode  of  the  previously  selected  buffer  if  that  variable 
is  the  null  string.  Normally  this  is  Fundamental  mode. 

To  return  to  buffer  1-00  later  after  having  switched  to  another,  the  same  command  C-X  B  KOO<cr>  is 
used,  since  C-X  B  can  tell  whether  a  buffer  named  KOO  exists  already  or  not.  It  does  not  matter  whether  you 
use  upper  case  or  lower  case  in  typing  the  name  of  a  buffer.  C-X  B  Main<cr>  reselecls  the  buffer  Main  that 
KMACS  slatted  out  with.  Just  C-X  IKcr>  icselcds  the  previous  buffer.  Repeated  C-X  U<cr>'s  alternate 
between  the  last  two  buffets  selected. 

You  can  also  lead  a  file  into  its  own  newly  created  bullet,  all  with  one  command:  C-X  C-F,  followed  by 
the  filename.  The  first  name  of  the  lilc  becomes  the  buffer  name.  C-F  stands  for  "Find",  because  if  the 
specified  file  already  resides  in  a  buffer  in  your  KMACS,  that  buffer  will  be  rcsclcclcd.  So  you  need  not 
remember  whether  you  have  brought  die  file  in  already  or  not.  A  buffer  -created  by  C-X  C-F  can  be 
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rcselcctcd  later  with  C-X  B  or  C-X  C*K  whichever  you  find  more  convenient.  Nonexistent  files  can  be 
created  with  C-X  CT'  just  as  they  can  be  with  C-X  C-V. 

If  the  buficr  with  die  same  name  that  C-X  C-K  wants  to  use  already  exists  but  with  the  wrong  contents 
(often  a  different  file  with  a  similar  name),  then  you  arc  asked  what  to  do.  You  can  type  Return  meaning  go 
ahead  and  use  the  buffer  for  this  new  file,  or  you  can  type  anodicr  buffer  name  to  use  instead  of  the  normal 
one.  If  C-X  C-K  docs  find  the  file  already  in  a  buffer,  then  it  checks  to  see  whether  the  version  on  disk  is  the 
same  as  the  last  version  read  or  vwiiten  from  that  buffer,  for  safety.  If  they  arc  different,  you  arc  warned  that 
someone  else  may  be  editing  the  file,  and  left  with  the  version  which  was  already  in  the  KMACS.  To  get  the 
new  version  from  disk  instead,  use  M-X  Revert  Kile. 

14.2.  Using  Existing  Buffers 

To  get  a  list  of  alt  the  buffers  that  exist,  do  C-X  C’-B  (I  ist  Buffers),  liaclt  buffer's  name,  major  mode,  and 
visited  filenames  arc  piintcd.  A  star  at  the  beginning  of  a  line  indicates  .1  buffer  which  contains  changes  that 
have  not  been  saved.  The  number  that  appears  before  a  buffer’s  name  in  a  C‘-X  C-B  listing  is  that  buffer's 
"buffer  number".  You  can  select  a  buffer  by  giv  ing  its  number  as  a  numeric  argument  to  C-X  B.  which  then 
does  not  need  to  read  a  siring  front  the  terminal. 

If  several  buffers  have  stars,  you  should  save  some  of  them  with  M-X  Save  Ail  Kilcs.  This  finds  all  the 
buffers  that  need  sav  ing  and  asks  about  each  one  indiv  idually.  Sav  ing  the  buffers  this  way  is  much  easier  and 
more  efficient  than  selecting  each  one  and  typing  C-X  C-S. 

A  quick  way  of  glancing  at  another  buffer,  faster  than  selecting  it,  is  to  use  M-X  View 
BufferKbuffernameXerX  This  displays  the  contents  of  the  other  buffer  and  lets  you  move  forward  and  back 
a  screen  at  a  time  with  Space  and  Backspace.  See  section  15  [Display],  page  71. 

M-X  Rename  BufferKnew  namcXcr>  changes  the  name  of  the  currently  selected  buffer.  If  <ncw  namc> 
is  the  null  string,  the  first  filename  of  the  visited  file  is  the  used  for  the  new  name  of  the  buffer. 

The  commands  C-X  A  (~R  Append  to  Buffer)  and  M-X  Insert  Buffer  can  be  used  to  copy  text  from  one 
buffer  to  another.  See  section  9.3  [Copying],  page  38. 


14.3.  Killing  Buffers 

After  you  use  an  KMACS  for  a  while,  it  may  fill  up  with  buffers  which  you  no  longer  need.  Eventually 
you  can  reach  a  point  where  trying  to  create  any  more  results  in  an  "URK"  error.  So  whenever  it  is 
convenient  you  should  do  M-X  Kill  Some  Buffers,  which  asks  about  each  buffer  individually.  You  can  say  Y 
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or  N  to  kill  it  or  not.  Or  you  can  say  Control-R  to  take  a  look  at  it  first.  This  docs  not  actually  select  the 
buffer,  as  the  mode  line  shows,  but  gives  you  a  recursive  editing  level  in  which  you  can  move  around  and  look 
at  things.  When  you  have  seen  enough  to  make  up  your  mind,  exit  the  recursive  editing  level  with  a  C-M-C 
and  you  will  be  asked  the  question  again.  If  you  say  to  kill  a  buffci  that  needs  saving,  you  will  be  asked 
whether  it  should  be  saved. 

You  can  kill  the  buffer  KOO  by  doing  C-X  K  l  '00<cr>.  You  can  kill  the  current  buffci,  a  common  thing 
to  do  if  you  use  C-X  CT,  by  doing  C-X  K<cr>.  If  you  kill  the  current  buffer,  in  any  way,  l-’MACS  asks  you 
which  buffer  to  select  instead.  Saying  just  <cr>  at  that  point  tells  l-MACS  to  choose  one  reasonably.  C-X  K 
runs  the  function  Kill  Buffer. 
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15.  Controlling  the  Display 

C-I.  Clear  and  redisplay  screen,  with  point  at  specified  place. 

C-V  Scroll  forwards  (a  screen  or  a  few  lines). 

M-V  Scroil  backwards. 

M-R  More  point  to  given  vertical  position. 

C-M-R  Get  this  function  onto  the  screen. 

The  terminal  screen  is  rarely  large  enough  to  display  all  of  your  file.  If  the  whole  buffer  doesn’t  fit  on  die 
screen,  l-’MACS  shows  a  contiguous  portion  of  it,  containing  point.  It  continues  to  show  approximately  the 
same  portion  until  point  moves  outside  of  it:  then  KM  ACS  chooses  a  new  portion  centered  around  the  new 
point.  This  is  KMACS’s  guess  as  to  what  you  arc  most  interested  in  seeing.  But  if  the  guess  is  wrong,  you  can 
use  the  display  contiol  commands  to  sec  a  different  portion.  The  Unite  aic.i  of  screen  thmugh  which  you  can 
sec  part  of  the  buffer  is  called  "the  window",  and  the  choice  of  where  in  the  buffer  to  stall  displaying  is  also 
called  "the  window". 

'flic  basic  display  control  command  is  C-I.  CR  New  Window),  in  its  simplest  form,  with  no  argument,  it 
dears  the  screen  and  tells  l-’M  ACS  to  display  a  portion  of  the  lnifTcr  centered  around  where  point  is  currently 
located  (actually,  point  is  placed  35%  of  the  way  down  from  the  top;  this  percentage  is  controlled  by  the  (lag 
KS  %  CKNTKR*.  whose  value  is  the  percent  of  the  screen  down  from  the  top.  See  section  22.5  |KS  Flags], 
page  117.). 

C-I.  with  a  positive  argument  chooses  a  new  window  so  as  to  put  point  that  many  lines  from  the  top.  An 
argument  of  zero  puts  point  on  the  very  top  line.  Point  docs  not  move  with  respect  ui  the  text:  rather,  the  text 
and  point  move  rigidly  on  the  screen.  C-I.  with  a  negative  argument  puts  point  that  many  lines  from  the 
bottom  of  the  window.  Kor  example,  C-U  -1  C-I.  puts  point  on  the  bottom  line,  and  C-U  -5  C-I.  puts  it  five 
lines  from  the  bottom.  C-I.  with  an  argument  docs  not  clear  the  screen,  so  that  it  car.  move  the  text  on  the 
screen  without  sending  it  again  if  the  terminal  allows  that. 

C-U  C-I.  is  different  from  C-I.  with  any  other  sort  of  argument.  It  causes  the  line  containing  point  to  be 
redisplayed  but  not  the  whole  screen. 

If  you  want  to  sec  a  few  more  lines  at  the  bottom  of  the  screen  and  don’t  want  to  guess  what  argument  to 
give  to  C-l„  you  can  use  the  C-V  (*R  Next  Screen)  command.  C-V  with  an  aigumenl  shows  you  that  many 
more  lines  at  the  bottom  of  the  screen,  moving  the  text  and  point  up  together  as  C-I.  might.  C-V  with  a 
negative  argument  shows  you  more  lines  at  the  top  of  the  screen,  as  does  Meta-V  (*R  Previous  Screen)  with  a 
positive  argument. 

Often  you  want  to  read  a  long  file  sequentially.  For  this,  (he  C-V  command  without  an  argument  is  ideal; 
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it  takes  the  last  two  lines  at  the  bottom  of  the  sciccn  and  puts  them  at  the  top.  followed  by  nearly  a  whole 
screenful  of  lines  not  visible  before.  Point  is  put  at  the  top  of  the  screen.  Thus,  each  C-V  shows  the  "next 
screenful",  except  for  two  lines  of  overlap  to  provide  continuity.  'Hie  variable  Next  Screen  Context  lines,  if 
defined,  controls  how  many  lines  front  the  bottom  of  the  screen  move  to  the  top;  the  default  if  the  variable  is 
not  defined  is  2.  To  move  backward,  use  M-V  without  an  argument,  which  moves  a  whole  screenful 
backwards  (again  with  overlap). 

Scanning  by  screen  Pols  through  the  buffer  for  some  distance  is  most  conveniently  done  with  the  M-X  View 
buffer  command.  This  command  enters  .1  simple  subsystem  in  which  Space  moves  a  screenful  forward  and 
backspace  moves  a  succnful  backward.  The  Return  character  exits,  leaving  point  centered  in  whatever  part 
of  the  buffer  was  visible.  An)  other  character  exits  and  returns  point  to  its  foimer  location,  and  is  then 
executed  as  a  command  (unless  it  is  a  Rubout:  Rollout  exits  but  is  not  executed).  View  Buffer  can  be  used  to 
view  another  buffer  In  giving  the  buffer's  name  as  a  string  argument.  In  this  case,  exiting  w  itb  Return  moves 
point  peimancntly  in  the  otltei  buffer,  but  does  not  select  it.  See  section  14  |buflm|,  page  67. 

You  can  also  scan  by  screenfuls  through  a  file  which  you  have  not  visited  with  the  M-X  View  l;ilc 
command.  See  section  13.7  (Advanced  bile  Commands},  page  63. 

To  scroll  the  buffer  so  tb.it  the  current  function  or  paragraph  *s  positioned  conveniently  on  the  screen,  use 
the  C-M-R  command  (~R  Reposition  Window).  'Ihis  command  tries  to  get  as  much  as  possible  of  the 
current  function  or  paragraph  onto  the  screen,  preferring  the  beginning  to  the  end,  but  not  moving  point  off 
the  screen.  A  "function”  in  Lisp  mode  is  a  defun:  otherwise  it  is  defined  to  be  a  set  of  consecutive 
unindented  lines,  or  a  set  of  consecutive  indented  lines. 

C-i.  in  all  its  forms  changes  the  position  of  point  on  the  screen,  carrying  the  text  with  it.  Another 
command  moves  point  the  same  way  but  leaves  the  text  fixed.  It  is  called  Mcla-R  (*R  Move  to  Screen  bdge). 
With  no  argument,  it  puts  point  at  the  center  of  the  screen.  An  argument  is  used  to  specify  the  line  to  put  it 
on.  counting  from  the  top  if  the  argument  is  positive,  or  from  the  bottom  if  it  is  negative.  Thus.  Meta-R  with 
ail  argument  of  0  puts  the  cursor  on  the  top  line  of  die  screen.  Metn-R  never  causes  any  text  to  move  on  the 
screen;  it  causes  point  to  move  with  respect  to  die  screen  and  the  text 
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16.  Two  Window  Mode 


C-X  2 

Start  showing  two  windows. 

C-X  3 

Show  two  windows  but  stay  "in"  the  top  one. 

C-X  1 

Show  only  one  window  again. 

C-XO 

Switch  to  the  Other  window 

C-X  4 

Find  buffer,  file  or  tag  in  other  window. 

C-X  A 

Make  this  window  bigger. 

C-M-V 

Scroll  the  other  window. 

Norm, illy,  KM  ACS  is  in  “one-window  mode",  in  which  a  single  body  of  text  is  \isiblc  on  the  screen  and 
can  be  edited.  At  limes,  it  is  useful  to  have  parts  of  two  different  files  \i:.ib!c  at  once,  l  or  example,  while 
adding  to  a  piogram  a  use  of  an  unfamiliar  feature,  one  might  wish  to  see  the  documentation  of  that  feature  at 
the  same  time.  Two-window  inode  makes  this  possible. 

Hie  command  C-X  2  (~R  Two  Windows)  enters  two-window  inode.  A  line  of  dashes  appears  across  the 
middle  of  the  screen,  dividing  the  text  display  area  into  two  halves.  Window  one,  containing  the  same  text  as 
previously  occupied  the  whole  screen,  fills  the  top  half,  while  window  two  fills  the  bottom  half.  Hie  cursor 
moves  to  window  two.  If  tins  is  your  first  entry  to  two-window  mode,  window  two  will  contain  a  new  buffer 
named  W2.  Otherwise,  it  will  contain  die  same  text  it  held  the  last  time  you  looked  at  it.  The  mode  line  will 
now  describe  die  buffer  and  file  in  window  two.  It’s  hard  to  provide  a  mode  line  for  each  window,  but 
making  the  mode  line  apply  to  the  window  you  arc  in  is  the  next  best  thing. 

You  can  now  edit  in  window  two  as  you  wish,  while  window  one  remains  visible.  When  you  arc  finished 
editing  or  looking  at  the  text  in  window  two.  C-X  1  (AR  One  Window)  returns  to  one-window  mode. 
Window  one  expands  to  fill  the  whole  screen,  and  window  two  disappears  until  the  next  C-X  2. 

While  you  arc  in  two  window  mode  you  can  use  C-X  0  (~R  Other  Window)  to  switch  between  the 
windows.  After  doing  C-X  2,  the  cursor  is  in  window  two.  Doing  C-X  O  moves  the  cursor  back  to  window 
one,  to  exactly  where  it  was  before  the  C-X  2. .  The  difference  between  this  and  doing  C-X  1  is  that  C-X  O 
leaves  window  two  visible  on  the  screen.  A  second  C-X  O  moves  die  cursor  back  into  window  two,  to  where 
it  was  before  the  first  C-X  0.  And  so  on... 

Often  you  will  be  editing  one  window  while  using  the  other  just  for  reference.  Then,  the  command  C-M-V 
(AR  Scroll  Other  Window)  is  very  useful.  It  scrolls  the  other  window  without  switching  to  it  and  switching 
back.  It  scrolls  (he  same  way  C-V  docs:  with  no  argument,  a  whole  screen  up;  with  an  argument,  that  many 
lines  up  (or  down,  for  a  negative  argument).  With  just  a  minus  sign  (no  digits)  as  an  argument,  C-M-V  scrolls 
a  whole  screenful  backwards  (what  M-V  docs). 

When  you  are  finished  using  two  windows,  the  C-X  1  command  makes  window  two  vanish.  It  doesn’t 
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mailer  which  window  the  cursor  is  in  when  you  do  the  C-X  1;  either  way  window  two  vanishes  and  window 
one  remains.  To  make  window  one  vanish  and  window  two  remain,  give  C-X  1  an  argument 

Tlic  C-X  3  (~R  View  Two  Windows)  command  is  like  C-X  2  but  leaves  the  cursor  in  window  one.  'Ifiat  is. 
it  makes  window  two  appear  at  the  bottom  of  the  screen  but  leaves  the  cursor  where  it  was.  C-X  2  is 
equivalent  to  C-X  3  C-X  O.  C-X  3  is  equivalent  to  C-X  2  C-X  O,  but  C-X  3  is  much  faster. 

Normally,  the  screen  is  divided  evenly  between  the  two  windows.  You  can  also  redistribute  the  lines 
between  the  windows  with  the  C-X  '  (~R  Grow  Window)  command.  It  makes  the  currently  selected 
window  get  one  line  bigger,  or  as  many  lines  as  is  specified.  With  a  negative  argument,  it  makes  the  selected 
window  smaller.  Hie  allocation  of  space  to  the  windows  is  always  remembered  and  changes  only  when  you 
give  a  C-X  *  command. 

After  leaving  two-window  mode,  you  can  still  use  C-X  0,  but  the  effect  is  slightly  different.  Window  two 
does  not  appear,  but  whatever  was  being  shown  in  it  appears,  in  window  one  (the  whole  screen).  Whatever 
buffer  used  to  be  in  window  one  is  stuck,  invisibly,  into  window  two.  Another  C-X  O  reverses  the  effect  of 
the  first,  l  or  example,  if  window  one  shows  buffer  II  and  window  two  shows  buffer  W2  (the  usual  ease),  and 
onlj  window  one  is  visible,  then  after  a  C-X  0  window  one  shows  buffer  W2  and  window  two  shows  buffer 
11. 

16.5.  Multiple  Windows  and  Multiple  Buffers 

You  can  view  one  buffer  in  both  windows.  Give  C-X  2  an  argument  as  in  C-U  C-X  2  to  go  into  window 
two  viewing  the  same  buffer  as  window  one.  Although  the  same  buffer  appears  in  both  windows,  they  have 
different  values  of  point,  so  you  can  move  around  in  window  two  while  window  one  continues  to  show  the 
same  text.  'Ilicn.  having  found  in  -  indow  two  the  place  you  wish  to  refer  to,  you  can  go  back  to  window  one 
with  C-X  0  to  make  your  changes.  Finally  you  can  do  C-X  1  to  make  window  two  leave  live  screen.  If  you 
arc  already  in  two  window  mode,  C-U  C-X  O  switches  windows  carrying  the  buffer  from  the  old  window  to 
the  new  one  so  that  both  are  viewing  the  same  buffer. 

buffers  can  he  selected  independently  in  each  window,  "flic  C-X  1}  command  selects  a  new  buffer  in 
whichever  window  the  cursor  is  in.  The  other  window  s  buffer  dins  not  change.  When  you  do  C-X  2  and 
window  two  appears  it  shows  whatever  buffer  used  to  he  visible  in  it  when  it  was  on  the  screen  last. 

If  you  have  the  same  buffer  in  both  windows,  you  must  beware  of  trying  to  visit  a  different  file  in  one  of 
the  windows  with  C-X  C-V,  because  if  you  bring  a  new  file  into  this  buffer,  it  will  replace  the  old  file  in  baih 
windows.  To  view  different  files  in  the  two  windows  again,  you  must  switch  buffers  in  one  of  the  windows 
first  (with  C-X  H  or  C-X  C-F,  perhaps). 
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A  convenient  "combination"  command  for  viewing  something  in  the  oilier  window  is  C-X  4  (*R  Visit  in 
Ollier  Window).  With  this  command  you  can  ask  to  see  any  specified  buffer,  file  or  tag  in  die  other  window. 
Follow  the  C-X  4  with  cither  B  and  a  buffer  name.  F  or  C-F  and  a  file  name,  or  T  or  and  a  tag  name  (Sec 
section  21  [TAGS],  page  101.).  'Iliis  switches  to  the  other  window  and  finds  there  what  you  specified.  If  you 
were  previously  in  one-window  mode,  two-window  mode  is  entered. 
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17.  Narrowing 


C-X  N  Nariow  down  to  between  point  and  mark. 

C-X  W  Widen  to  view  the  entire  buffer. 

C-X  P  Narrow  down  to  the  page  point  is  in. 

"Narrowing"  means  focusing  in  on  some  portion  of  the  buffer,  making  the  rest  temporarily  invisible  and 
inaccessible. 

When  you  have  narrowed  down  to  a  part  of  the  buffer,  that  part  appears  to  be  all  there  is.  You  can't  sec 
the  rest,  you  can’t  move  into  it  (motion  commands  won’t  g.>  outside  the  visible  part),  you  can’t  change  it  in 
any  way.  1  low  ever,  it  is  not  gone,  and  if  you  save  the  (lie  you  arc  editing  all  the  invisible  text  w-iil  he  saved.  In 
addition  to  sometimes  making  it  easier  to  concciutatc  on  a  single  subroutine  or  pningruph  by  eliminating 
clutter,  narrow  Ing  can  be  u  .cd  to  rcsli  id  the  langc-  of  operation  of  a  replace  command. 

The  pritr,  ay  nauowing  command  is  C-X  N  (*R  Set  Hounds  Region).  It  sets  the  'Virtual  buffer 
boundaries"  at  point  and  the  mark,  so  that  only  what  was  between  them  remains  visible.  Point  moves  to  the 
top  of  the  novv-v  isible  range,  and  the  mark  is  left  at  the  end,  so  that  the  region  marked  is  unci  mged. 

The  way  to  mu' )  nanovving  is  to  widen  with  C-X  W  (•'R  Set  Hounds  I'uil).  This  makes  all  text  in  the 
buffer  accessible  again. 

Another  way  to  narrow  is  to  narrow  to  just  one  page,  with  C-X  P  (~R  Set  Bounds  Page).  See  section  18 
[Pages],  page  79. 

You  can  get  information  on  what  part  of  the  buffer  you  arc  narrowed  down  to  using  the  C-X  = 
command.  See  section  1 1.4  [Filling],  page  47. 

Note  that  the  virtual  buffer  boundaries  arc  a  powciful  I'HC’O  mechanism  used  internally  in  KMACS  in 
many  ways.  While  only  the  commands  described  here  set  them  so  as  you  can  see,  many  others  set  them 
temporal ily  using  f’cTHCO  commands  FS  VB4  and  FS  V/T,  and  rcsltne  them  before  finishing. 
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18.  Commands  for  Manipulating  Pages 

C-M-L  Insert  formfeed. 

C-X  C-P  Pm  point  and  mark  around  this  page  (or  another  page). 

C-X  [  Move  point  to  previous  page  boundary. 

C-X  ]  Move  point  to  next  page  boundary. 

C-X  I1  Narrow  down  to  just  this  (or  next)  page. 

C-X  I.  Count  (lie  lines  in  this  page. 

M-X  What  r'age 

Print  current  page  and  line  number. 

Files  arc  often  thought  of  as  divided  into  pages  by  the  ASCII  character  foimfeed  (t  I .).  For  example,  if  a 
lile  is  plinicd  on  a  line  pi  inter,  each  page  of  the  (lie.  in  this  sense,  will  start  on  a  new  page  of  paper. 

Most  editois  make  the  division  of  a  file  into  pages  extremely  important.  For  example,  they  may  be  unable 
to  show  more  than  one  page  of  the  file  at  any  time.  F'MACS  treats  a  formfeed  chuiactcr  just  like  any  other 
character.  It  can  be  in  soiled  with  C-Q  C-l.  (or,  C-M-l ),  and  deleted  with  Kubout.  Thus,  you  aie  free  to 
paginate  your  file,  or  not.  However,  since  pages  aie  often  meaningful  divisions  of  the  lile,  commands  arc 
provided  to  move  over  them  and  operate  on  them.  If  you  happen  to  like  seeing  only  one  page  of  the  file  at  a 
time,  you  can  use  the  PACK  library  for  that.  Sec  section  18.1  [PAGH],  page  80. 

The  C-X  [  (aR  Previous  Page)  command  moves  point  to  the  previous  page  delimiter  (actually,  to  right 
after  it).  If  point  starts  out  right  after  a  page  delimiter,  it  skips  that  one  and  stops  at  the  previous  one.  A 
numeric  aigumcnt  serves  as  a  repeat  count.  The  C-X  j  (AR  Next  Page)  command  moves  past  the  next  page 
delimiter. 

The  comn  and  M-X  Wh.it  Page  prints  the  page  and  line  number  of  the  cursor  in  the  echo  area.  I'hcie  is  a 
separate  command  to  print  this  information  because  it  is  likely  to  be  slow  and  should  not  slow  down  anything 
else  (The  design  ofTHCO  is  such  that  it  is  not  possible  to  know  the  absolute  number  of  the  page  you  arc  in, 
except  by  scanning  through  the  whole  file  counting  pages). 

The  C-X  C-P  command  (AU  Mark  Page)  puts  point  at  the  beginning  of  the  current  page  and  the  mark  at 
the  end.  The  page  terminator  at  the  end  is  included  (the  mark  follows  it).  That  at  the  front  is  excluded  (point 
follows  it).  '1'his  command  can  be  followed  by  a  C-W  to  kill  a  page  which  is  to  be  moved  elsewhere. 

A  numeric  aigumcnt  to  C-X  C-P  is  used  to  specify  which  page  to  go  to,  relative  to  the  current  one.  Zero 
means  the  current  page.  One  means  the  next  page,  and  -1  means  the  previous  one. 

The  command  C-X  P  (Ai<  Set  Bounds  Page)  narrows  down  to  just  one  page.  Hvcrything  before  and  after 
becomes  temporarily  invisible  and  inaccessible  (See  section  17  [Narrowing],  page  77.).  Use  C-X  W  to  undo 
this.  Both  page  terminators,  the  preceding  one  and  the  following  one,  arc  excluded  from  the  visible  region. 
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Like  C  X  C-P,  llie  C-X  P  command  normally  selects  the  current  page,  but  allows  you  to  specify  which  page 
explicitly  relative  to  the  current  one  with  a  numeric  argument.  However,  when  you  arc  already  narrowed 
down  to  one  page,  C-X  P  moves  you  to  the  next  page  (otherwise,  it  would  be  a  useless  no-op).  One  effect  of 
this  quirk  is  that  several  C-X  P’s  in  a  row  get  fust  the  current  page  and  then  successive  pages. 

Just  what  delimits  pages  is  controlled  by  the  variable  Page  Delimiter,  which  should  contain  a  THCO  search 
string  (See  section  19.3  (THCO  search  strings],  page  85.)  which  will  match  a  page  separator.  Normally,  it 
contains  a  siring  containing  just  t|„  For  an  INFO  file,  it  might  usefully  be  changed  to  t_t|.tOt_,  which 
means  that  either  a  t_t|.  or  just  a  t_  (whatever  separates  INFO  nodes)  should  be  a  page  separator.  In  any 
ease,  page  separators  are  recogni/cd  as  such  only  at  the  beginning  of  a  line.  ITic  paragraph  commands 
consider  each  page  boundary  a  paragraph  boundary  as  well. 

The  C-X  I.  command  ('R  Count  Lines  Page)  is  good  for  deciding  where  to  break  a  page  in  two.  It  first 
prints  (in  the  echo  area)  the  total  number  of  lines  in  the  current  page,  and  then  divides  it  up  into  those 
pi  cuding  die  cut  rent  line  and  those  following,  as  in 
Page  has  90  lines  (72+25) 

Notice  that  the  sum  is  off  by  one;  this  is  collect  if  point  is  not  at  the  fioni  of  a  line. 

1 8. 1 .  ICtlilinj'  Only  C  lie  Page  at  a  l  ime 

The  PACIIi  library  is  meant  to  allow  the  handling  of  pages  as  discrete,  often  independent  units,  letting  you 
see  only  one  page  at  a  time,  and  providing  commands  to  move  between  pages,  split  pages  and  join  pages.  It 
contrives  to  show  the  number  of  the  page  you  are  looking  at  in  the  mode  line.  You  can  also  ask  to  see  a 
"directory"  of  the  pages  in  the  file,  or  to  insert  it  into  the  file.  I  bis  is  an  extension  of  and  replacement  for  the 
facility  provided  by  the  C-X  P  command  in  stnndaid  F.MACS.  it  is  an  optional  library  because  we  do  not 
think  it  is  necessarily  an  improvement. 

The  commands  in  the  PAG  I-  library  supplant  and  redefine  commands  in  standard  F.MACS.  Therefore, 
you  cannot  use  them  unless  you  give  the  command  M-X  Load  Library* PAGK<er>  explicitly.  See  section  22.2 
{I  .Hilaries],  page  112. 

C-X  ]  Move  to  next  page. 

C-X  [  Move  to  previous  page. 

C-X  C-P  Move  to  page  by  absolute  number. 

C-X  P  Split  this  page  at  point. 

C-X  J  Join  this  page  to  the  next  or  previous  one. 

C-X  W  See  the  whole  file  again. 

The  most  fundamental  tiling  to  do  with  PAGF.  is  to  go  to  a  specific  page.  This  can  be  done  by  giving  the 
page  number  as  an  argument  to  C-X  C-P("R  Goto  Page),  if  you  give  a  number  too  big,  the  last  page  in  the 
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file  is  selected. 

For  convenience,  C-X  C-P  with  no  argument  when  you  are  looking  at  the  whole  file  selects  the  page 
containing  point.  When  you  arc  looking  at  only  one  page.  C-X  C-P  with  no  argument  goes  to  the  next  page 
and  with  a  negative  argument  goes  to  the  previous  page. 

However,  the  main  commands  for  moving  forward  or  backward  by  pages  are  C-X  f  and  C-X  j  (*11  Goto 
Previous  Page  and  Goto  Next  Page).  These  take  a  numeric  argument  (either  sign)  and  move  that  many 
pages. 

When  you  want  to  go  back  to  viewing  the  whole  file  instead  of  just  one  page,  you  can  use  the  C-X  W 
(~R  Widen  Hounds)  command.  Ilicsc  arc  the  same  characters  that  you  would  use  in  standard  liMACS,  but 
they  run  a  different  function  that  knows  to  remove  the  page  number  from  the  mode  line. 

The  C-S  ('K  Inciemental  Search)  and  C-R  (~R  Reverse  Search)  are  redefined  to  widen  bounds  first  and 
narrow  them  again  afterwards.  So  you  can  scaiclt  through  the  whole  file,  but  afterward  see  only  the  page  in 
which  the  search  ended.  In  fact.  PAG  I:  goes  through  some  tumble  to  work  with  whatever  senich  functions 
you  prefer  to  use,  and  find  them  wherever  you  put  them. 

To  split  an  existing  page,  you  could  insert  a  tl„  but  unless  yon  do  this  while  seeing  the  whole  file,  I’AGF 
might  get  confused  for  a  while.  A  way  that  is  less  tricky  is  to  use  C-X  P  (~R  Inscil  I’agemark)  which  inserts 
the  page  mark,  and  narrows  down  to  the  second  of  the  two  pages  formed  from  the  old  page.  To  get  rid  of  a 
page  mark  without  worry,  use  C-X  J  (~R  Join  Next  Page).  It  gets  rid  of  the  page  mark  after  the  current  page; 
or,  with  a  negative  argument,  gets  rid  of  the  page  mark  before  this  page. 

A  page  mark  is  defined  as  <CRI,F>tL  if  you  set  the  variable  PAGli  Hush  CRM'  to  1,  a  page  mark  is  be 
<CRM->t|.<CRIJ->,  which  has  the  effect  of  making  the  CRI.Fat  the  beginning  of  each  page  invisible,  'litis 
may  he  desirable  for  PM  ACS  library  source  files.  You  can  also  specify  some  other  string  in  place  of  M.:  the 
value  of  Page  Delimiter  will  be  used.  If  Page  Delimiter  specifies  multiple  alternatives,  the  fust  alternative  is 
the  one  PAGP  will  inscit.  hut  all  will  be  recognized,. 

To  sec  a  list  of  all  the  pages  in  the  file,  each  one  represented  by  its  liist  nonempty  line,  use  M-X  View  Page 
Directory.  It  pi  inis  out  the  first  non-blank  line  on  each  page,  pieeedcd  by  its  page  number.  M-X  Insert  Page 
Directory  inseus  the  same  directory  into  the  buffer  at  point.  If  you  give  it  an  nigumcnl.  it  tries  to  make  the 
whole  thing  into  a  comment  by  putting  the  Comment  Start  siting  at  the  front  of  each  line  and  the  Comment 
Pud  string  at  the  end. . 

If  the  variable  Page  Setup  Hook  exists,  PAGiv  will  execute  its  value  as  the  function  for  placing  PAGIi’s 
functions  on  keys. 
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19.  Replacement  Commands 

Global  scarch-a'nd-replace  operations  are  not  used  as  often  in  HMACS  as  they  arc  in  other  editors,  but 
they  are  still  provided.  In  addition  to  the  simple  Replace  operation  which  is  like  that  found  in  most  editors, 
there  is  a  Quciy  Replace  operation,  which  asks  you,  for  each  occurrence  of  the  pattern,  whether  to  replace  it. 

19.1.  Query  Replace 

To  replace  every  instance  of  I'OO  with  BAR.  you  can  do  M-X  Replace* POO* BA R<cr>.  Replacement  is 
done  only  after  point,  so  if  you  want  to  cover  the  whole  buffer  you  must  go  to  the  beginning  first.  Unless  the 
vaiiable  Case  Replace  is  zero,  an  attempt  is  made  to  preserve  ease:  give  both  I'OO  and  BAR.  in  lowercase, 
and  if  a  particulai  I  'OO  is  found  with  a  capital  initial  or  all  capitalized,  the  BAR  which  replaces  it  will  be 
likewise. 

If  you  give  Replace  (or  Query  Replace)  an  argument,  then  it  insists  that  the  occui renecs  of  POO  be 
delimited  by  break  diameters  (or  an  end  of  the  buffer).  So  you  can  find  only  the  word  I  'OO,  and  not  1-00 
when  it  is  part  of  l-'OOBAR. 

'l  o  icstrict  the  replacement  a  subset  of  the  buffer,  set  the  region  around  it  and  type  C-X  N  ("N"  for 
"Narrow").  I  bis  makes  all  of  the  buffer  outside  that  region  temporarily  invisible  (but  the  commands  that 
save  your  file  still  know  that  it  is  there!).  Then  do  the  replacement.  Afterward,  C-X  W  ("Widen")  to  make 
the  rest  of  the  buffer  visible  again.  See  section  17  [Narrowing],  page  77. 

If  you  arc  afraid  that  there  may  be  some  POO’S  that  should  not  be  changed,  HMACS  can  still  help  you. 
Use  M-X  Query  Replace* I'OO* BA R<cr>.  'litis  displays  each  l;00  and  waits  for  you  to  say  whether  to 
replace  it  with  a  B  AR.  'Ihc  things  you  can  type  when  you  arc  shown  a  l;00  arc: 

Space  to  replace  the  1-00  (preserving  ease,  just  like  plain  Replace,  unless  Case  Replace  is 
zero). 

Rubout  to  skip  to  the  next  1-00  without  replacing  this  one. 

Comma  to  replace  this  l;UO  and  display  the  result.  You  are  then  asked  lor  another  input 
character,  except  that  since  the  replacement  has  already  been  made,  Rubout  and 
Space  are  equivalent. 

Altmode  to  exit  without  doing  any  more  replacements. 

Period  to  replace  this  POO  and  then  exit. 

!  to  replace  al!  icmaiuing  POO’s  without  asking  (Replace  actually  works  by  calling 

Query  Replace  and  pretending  that  a !  was  typed  in). 

*  to  go  back  to  the  previous  P'OO  (or,  where  it  was),  in  case  you  have  made  a  mistake. 

'litis  works  by  jumping  to  the  mark  (Query  Replace  sets  the  mark  each  time  it  finds  a 

100). 

C-R  to  enter  a  recursive  editing  level,  in  ease  the  1*00  needs  to  be  edited  rather  than  just 
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replaced  with  a  BAR.  When  you  arc  done,  exit  the  recursive  editing  level  with 
C-M-C. 

C-W  to  delete  the  FOO.  and  then  stmt  editing  the  buffer.  When  you  arc  finished  editing 

whatever  is  to  replace  the  FOO.  exit  the  recursive  editing  level  with  C-M-C. 

I  f  you  type  any  other  character,  the  Query  Replace  is  exited,  and  the  character  executed  as  a  command.  To 
restart  the  Query  Replace,  use  C-X  Altmodc  which  is  a  command  to  re-cxccutc  the  previous  minibuffer 
command  or  extended  command.  Sec  section  5  (M-X],  page  19. 

The  first  argument  of  Query  Replace  and  Replace  String  is  not  simply  a  string;  it  is  a  kind  of  pattern,  a 
TFCO  search  string.  See  section  19.3  [TFCO  search  strings],  page  85. 

19.1.1.  Running  Query  Replace  with  (lie  Minilniffer 

Meta-%  gives  you  a  minibuffer  prc-initiali/.ed  with  “MM  Query  Replace*".  'Ibis  is  the  easiest  way  to 
invoke  Query  Replace.  It  also  allows  you  to  get  Returns  and  Altmodes  into  the  arguments. 

With  the  ininibulfer.  Query  Replace  can  be  given  a  ptccoinma  argument,  which  says  that  the  second  siring 
argument  is  actually  a  TFCO  program  to  be  executed  to  perform  llv;  replacement,  rather  than  simply  a  string 
to  replace  with. 

When  you  invoke  Query  Replace  from  the  ininibulfer.  the  character  C-j  becomes  special  (because  it  is 
special  in  TFCO  programs).  In  order  to  get  a  C-|  into  the  search  string  or  the  replacement  siring,  you  must 
use  two  of  them.  You  can  also  use  a  C-|  to  quote  an  Altmodc.  In  the  minilniffer.  Return  has  no  syntactic 
significance,  so  there  is  no  need  for  a  way  to  quote  it  However,  in  order  to  insert  any  control  characters  into 
the  arguments,  you  need  to  quote  them  again  with  C-Q.  So,  to  get  C-Q  C-X  into  the  search  string  so  as  to 
search  for  a  C-X,  you  have  to  type  C-Q  C-Q  C-Q  C-X. 

19.2.  Ollier  Sc;irch*an<Moop  Functions 

Here  arc  some  other  functions  related  to  replacement.  Their  arguments  are  TFCO  search  strings  (See 
section  19.3  [TFCO  search  su  ings|.  page  85.).  Ibey  all  operate  from  point  to  the  end  of  the  buffer  (or  where 
C-X  N  stops  them). 

M-X  Occur  *FOO<cr> 

which  finds  all  occurrences  of  FOO  after  point.  It  prints  each  line  containing  true.  With  an 
argument,  it  prints  that  many  lines  before  and  alter  each  occurrence. 

M-X  I  low  Many*FOO<cr> 

types  the  number  of  occurrences  of  FOO  al  ter  point. 


M-X  Keep  Fines* FOO<cr> 


Replacement  Commands 
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kills  all  lines  after  point  that  don't  contain  FOO. 

M-X  Rush  I.ines$FOO<cr> 

kills  all  lines  after  point  that  contain  FOO. 

19.3.  TECO  Search  Strings 

'Hie  first  string  argument  to  Replace  and  Query  Replace  is  actually  a  TKCO  search  string.  This  means  that 
the  characters  C-X.  C-B.  C-N,  C-O.  and  C-Q  have  special  meanings.  C-X  matches  any  character.  C-B 
matches  any  "delimiter"  character  (anything  which  the  word  commands  consider  not  part  of  a  word, 
according  to  the  syntax  table.  See  section  22.4  [Syntax],  page  1 15.).  C-N  negates  what  follows,  so  that  C-N  A 
matches  anything  but  A,  and  C-N  C-B  matches  any  non-delimiter.  C-O  means  "or",  so  that  XYXY  C-0  //./. 
matches  either  XYXY  or  /././..  C-O  can  be  used  more  titan  once  in  a  pattern.  C-Q  quotes  the  following 
character,  in  ease  you  want  to  search  for  one  of  the  special  control  characters.  I  lowcver.  you  can’t  quote  an 
Alttnode  or  a  Return  in  this  way  because  its  specialness  is  at  an  earlier  stage  of  processing. 

Some  variables  arc  supposed  to  have  TFCO  search  sitings  as  their  values.  For  example.  Page  I  Jelimiter  is 
supposed  to  be  a  search  string  to  match  anything  which  should  start  a  page,  litis  is  so  that  you  can  use  C-O  to 
match  several  alternatives.  In  die  values  of  such  variables,  C-B.  C-N,  C-O,  C-Q.  C-X  and  C-|  ate  special,  but 
Alttnode  is  not.  C-B  through  C-X  arc  quoted  with  a  C-Q,  and  C-]  is  quoted  with  another  C-]. 
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20.  luiiting  Programs 

Special  features  for  editing  programs  include  automatic  indentation,  comment  alignment,  parenthesis 
matching,  and  the  ability  to  move  over  and  kill  balanced  expressions.  Many  of  these  features  arc 
parameterized  so  that  they  can  work  for  any  programming  language. 

For  each  language  there  is  a  special  "major  mode"  which  customizes  I- MACS  slightly  to  be  better  suited  to 
editing  programs  written  in  that  language.  These  modes  sometimes  offer  special  facilities  as  well. 

Sec  section  1 1.1  (Words],  page  43.  Mining  over  words  is  useful  for  editing  programs  as  well  as  text. 

See  section  1 1.2  (Paragraphs],  page  44.  Most  programming  language  major  modes  define  paragraphs  to  be 
separated  only  by  blank  lines  and  page  boundaiies.  ‘Phis  makes  the  paragraph  commands  useful  for  editing 
programs. 

See  section  21  (Tags],  page  101.  The  TAOS  package  can  remember  all  the  labels  or  functions  in  a 
multi-file  program  and  find  any  one  of  them  quickly. 

20.1.  Major  Modes 

When  KM  ACS  starts  up.  it  is  in  what  is  called  "Kundamcntal  mode",  which  means  that  the  single  and 
double  character  commands  arc  defined  so  as  to  be  convenient  in  general.  More  precisely,  in  Kundamcntal 
mode  every'  KM  ACS  option  is  set  in  its  default  state.  For  editing  any  specific  type  of  text,  such  as  l.isp  code 
or  Knglish  text,  you  can  tell  l-!M  ACS  to  change  the  meanings  of  a  few  commands  to  become  more  specifically 
adapted  to  the  task.  Ibis  is  done  by  switching  from  Kundamcntal  mode  to  one  of  the  other  major  modes. 
Most  commands  remain  unchanged;  the  ones  which  usually  change  are  Tab,  Rubout.  and  Linefeed.  In 
addition,  the  commands  which  handle  comments  use  the  mode  to  determine  how  comments  arc  to  be 
delimited. 

Selecting  a  new  major  mode  is  done  with  an  M-X  command.  Kirch  major  mode  is  the  name  of  the  function 
to  select  that  mode.  ’Ibtis,  you  can  enter  l.isp  mode  by  executing  M-X  l.isp  (short  for  M-X  l.isp  Mode).  'Ibe 
major  modes  arc  mutually  exclusive;  you  can  he  in  oniy  one  major  mode  at  a  lime.  When  at  top  level, 
KM  ACS  always  says  in  the  mode  line  which  major  mode  you  arc  in.  You  can  specify  which  major  mode 
should  be  used  for  editing  a  certain  file  by  putting  -*-<mode  nan:e>-*-  somewhere  in  the  first  nonhlank  line 
of  the  file.  Kor  example,  this  file  has  -*-Tcxt-*\ 

Many  major  modes  redefine  the  syntactical  properties  of  characters  appearing  in  the  buffer.  See 
section  22.4  (Syntax],  page  1 15. 
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Most  programming  language  major  modes  specify  that  only  blank  lines  separate  paragraphs.  This  is  so 
that  the  paragraph  commands  do  not  become  useless.  'Iliey  also  cause  Auto  Fill  mode  to  use  die  definition  of 
Tab  to  indent  the  new  lines  it  creates.  This  is  because  most  lines  arc  usually  indented. 

Major  modes  are  standardly  defined  for  the  languages  l.isp.  Muddle.  MIDAS,  Maesyma.  HCPi BUSS, 
PASCAL  FORTRAN,  11:CO.  and  PL1. 

Hierc  is  also  Text  mode,  designed  for  editing  F'nglish  text,  or  input  to  text  justificr  programs.  Sec 
section  1 1  (Text],  page  43. 

20.2.  Compiling  Your  Program 

The  command  M-X  Compile<cr>  is  used  to  compile  the  visited  file.  It  knows  how  to  compile  it  based  on 
the  major  mode:  for  example,  in  MIDAS  mode,  it  works  by  invoking  MIDAS. 

The  first  thing  M-X  Compile  docs  is  offer  to  stive  each  buffer.  ‘Iliis  is  because  it  is  likely  that  till  the 
buffers  contain  parts  of  the  same  program  you  tire  about  to  compile. 

Then  your  program  is  compiled  by  executing  a  siring  of  DDT  commands.  Normally,  the  commands  arc 
constructed  from  the  visited  file  name  and  the  major  mode:  for  example,  in  MIDAS  mode,  the  command 
:MIDAS  <filename> 

would  be  used.  When  this  is  not  sufficient,  you  can  specify  what  to  do  by  defining  the  variable  Compile 
Command  to  he  a  TFCO  program  to  do  the  compilation.  It  could  work  by  using  the  tK  command  to  pass 
commands  to  DD  T.  Hie  TFCO  program  must  use  t\  toexiL 

In  some  languages,  all  the  files  of  a  multi-file  program  must  be  compiled  together,  and  the  compiler  must 
be  given  all  ih<_  files,  or  one  particular  file  which  specifics  all  the  others.  FiMACS  libraries  are  an  example  of 
the  first  sort,  and  MIDAS  programs  an  example  of  the  second  sort,  in  such  eases,  each  of  the  files  of  the 
program  could  define  a  Compile  Command  with  a  local  modes  list  which  specifics  all  the  files,  or  the 
appropriate  one.  Sec  the  file  AI:HMACS1;CCI.  >  for  an  example  of  doing  this  for  an  HM  ACS  library. 

Major  modes  which  are  not  known  to  M-X  Compile  can  work  with  it  by  setting  Compile  Command,  in 
this  *•  die  value  of  Compile  Command  must  be  independent  of  the  name  of  the  file.  When  it  is  executed,  it 
can  find  the  filename  to  use  in  ij-rcgistcr  I. 
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20.3.  Indentation  Commands  for  Code 

Tab  Indents  current  line. 

I .inefeed  I-qui vaient  to  Return  followed  by  'lab. 

M-"  Joins  two  lines.  leaving  one  space  between  if  appropriate. 

M-\  Deletes  all  spaces  and  tabs  around  point 

M-M  Moves  to  die  first  nonblank  character  on  the  line. 

Most  programming  languages  have  some  indentation  convention.  For  l.isp  code,  lines  arc  indented 
according  to  their  nesting  in  parentheses.  For  assembler  code,  almost  all  lines  start  with  a  single  tab.  but  some 
hn\e  one  or  more  spaces  as  well,  indenting  TKCO  code  is  an  art  rather  than  a  science,  but  it  is  often  useful  to 
indent  a  line  under  the  previous  one. 

flic  way  to  request  indentation  is  with  the  Tab  command.  I*ach  major  mode  defines  this  command  to 
perform  die  sou  of  indentation  appropriate  for  the  particular  language.  In  Lisp  mode,  lab  aligns  the  line 
according  to  its  depth  in  parentheses.  No  matter  where  in  the  line  you  arc  when  you  type  lab.  it  aligns  the 
line  as  a  whole.  In  MIDAS  mode.  Tab  inserts  a  tab,  that  being  die  standard  indentation  for  assembly  code. 
In  1HCO  mode.  Tab  realigns  die  current  line  to  match  a  previous  line.  I’Ll  mode  (Sec  the  file  INFO: 
KPI.1  >.)  knows  in  great  detail  about  the  keywords  of  the  language  so  as  to  indent  lines  according  to  the 
nesting  structure. 

Hie  command  Linefeed  ("R  Indent  New  Line)  docs  a  Return  and  then  docs  a  Tab  on  the  next  line.  llius. 
Linefeed  at  the  end  of  the  line  makes  a  following  blank  line  and  supplies  it  with  the  usual  amount  of 
indentation,  just  as  Return  would  make  an  empty  line.  Linefeed  in  the  middle  of  a  line  breaks  the  line  and 
supplies  the  usual  indentation  in  front  of  the  new  line. 

Ihc  inverse  of  Linefeed  is  Meta-"  or  C-M-"  ("R  Delete  Indentation),  'litis  command  deletes  the 
indentation  at  the  front  of  the  current  line,  and  the  line  boundary  as  well.  Ihcy  arc  replaced  by  a  single 
space,  or  by  no  space  if  before  a  ")”  or  after  a  ”("•  or  at  the  beginning  of  a  line.  To  delete  just  the  indentation 
of  a  line,  go  to  the  beginning  of  the  line  and  use  MetaA  ("R  Delete  Horizontal  Space),  which  deletes  all 
spaces  and  tabs  around  the  cursor. 

To  insert  an  indented  line  before  the  current  one,  do  C-A.  C-O,  and  tlicn  Tab.  To  make  an  indented  line 
after  the  current  one.  use  C-H  Linefeed. 

To  move  over  the  indentation  tin  a  line,  do  Meta-M  or  C-M-M  ("R  Back  to  Indentation).  These 
commands,  given  any  where  on  a  line,  position  the  cursor  at  the  first  nonhlauk  character  on  the  line. 
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20.4.  Automatic  Display  Of  Matching  Parentheses 


The  purpose  of  the  KM  ACS  parenthesis-matching  feature  is  to  slum  automatically  how  parentheses 
balance  in  text  being  typed  in.  When  this  feature  is  enabled,  after  a  close  parenthesis  or  other  close  bracket 
character  is  inserted  the  cursor  automatical!)  moves  for  an  instant  to  the  open  which  balances  the  newly 
inserted  character,  'lhe  cursor  stats  at  the  open  parenthesis  fora  second  before  returning  home,  if  you  don’t 
t>pc  any  more  commands  during  that  time,  if  you  type  more  commands  before  die  second  is  up.  KMACS 
won’t  wait  the  whole  second. 

It  is  worth  emphasizing  that  the  real  location  of  the  cursor,  the  place  where  your  type-in  will  be  inserted,  is 
not  alTeclcd  by  the  close  parenthesis  matching  feature.  It  slays  after  the  dose  parenthesis,  where  it  would 
normally  he.  Only  the  spot  on  the  screen  moves  away  and  back.  You  can  type  ahead  freely  as  if  the  matching 
feature  were  not  there.  In  fact,  if  you  type  fast  enough,  you  won’t  see  the  cursor  move.  You  must  pause  after 
ty  ping  a  close  parenthesis  to  see  the  open  parenthesis. 

Hie  variable  Display  Matching  Parcn  controls  parenthesis  display.  If  it  is  zero,  the  fcaiure  is  disabled.  If 
the  variable  is  nonzero,  then  its  absolute  value  is  the  number  of  seconds  for  the  cursor  to  stay  at  tlx?  open 
parenthesis  before  coming  back  to  its  real  location.  !hc  sign  of  the  variable  is  also  significant:  if  it  is  negative, 
then  the  open  parenthesis  is  show  n  only  if  it  is  already  on  the  serc-'n.  If  the  variable  is  positive,  then  KMACS 
will  actually  rcccnter  the  window  to  show  the  text  around  the  open  parenthesis.  Die  default  setting  of  the 
variable  is -1. 

An  additional  parameter  is  whether  KMACS  should  warn  you  by  ringing  the  bell  if  you  type  an 
unmatched  close  parenthesis.  Ilic  default  is  to  warn  you  if  you  arc  editing  a  language  in  which  parentheses 
arc  essential,  like  l.isp.  but  not  to  do  so  for  languages  in  which  parentheses  are  not  so  crucial,  'litis  is 
controlled  by  the  variable  Permit  Unmatched  Parcn.  When  it  is  1.  you  arc  never  warned  (they  are  always 
"permitted").  When  it  is  -1.  you  arc  warned  only  in  l.isp  mode  and  similar  modes  (this  is  die  default).  Note 
that  these  modes  operate  by  locally  setting  the  variable  to  1  if  it  was  -1.  When  it  is  0.  you  arc  warned 
regardless  of  the  major  mode.  Unmatched  parens  are  tihuiys  "permitted"  in  that  KMACS  will  never  refuse  to 
insert  them. 

While  this  feature  was  intended  primarily  for  l.isp.  it  can  be  used  just  as  well  for  any  other  language,  and  it 
is  not  dependent  on  what  major  mode  you  arc  in.  It  is  expected  that  you  wouldn't  want  it  in  Text  mode,  so 
Text  mode  sets  the  variable  I  Jispl.iy  Matching  Parcn  locally  to  zero.  If  you  do  want  the  feature  in  I  ext  mode, 
you  can  cicatc  a  Text  Mode  1  look  variable  which  sets  the  variable  hick  to  -I.  See  the  file  INK'OX’ONV  >. 
node  1  looks,  for  more  info  on  Text  Mode  Hook.  Ilic  way  to  control  which  characters  trigger  this  feature  is 
with  the  syntax  table.  Any  character  whose  l.isp  syntax  is  ")"  will  cause  the  matching  character  with  syntax 
"("  to  he  shown.  Most  major  modes  automatically  set  up  the  syntax  table  (See  section  22.4  [Syntax], 
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page  115.). 

The  syntax  table  also  controls  what  is  done  with  the  ease  of  "mismatched"  parens,  as  in  "[ )".  'Hie  third 
slot  in  a  close  parenthesis  character's  syntax  table  entry  should  be  the  proper  matching  open  parenthesis 
character,  if  you  want  this  feature  turned  on.  If  that  slot  contains  a  space  instead,  then  any  open  parenthesis 
character  is  considered  a  legitimate  match. 

'Hie  implementation  of  this  feature  uses  the  TKCO  flag  FS  "R  PARliN*.  See  section  22.5  (FS  Flags), 
page  117. 

20.5.  Manipulating  Comments 

The  comment  commands  insert,  kill  and  align  comments.  There  are  also  commands  for  moving  through 
existing  code  and  inserting  comments. 

C-;  Insert  or  align  comment 

M-;  The  same. 

C-M-;  Kill  comment. 

C-X  ;  Set  comment  column. 

M-N  Move  to  Next  line  and  insert  comment. 

M-P  Move  to  Previous  line  and  insert  comment. 

M-J  Continue  a  comment  on  a  new  line. 

M-l. indeed  'Ibc  same. 

The  command  that  creates  a  comment  is  Control-;  or  Meta-;  (~R  Indent  for  Comment).  It  moves  to  the 
end  of  the  line,  indents  to  the  comment  column,  and  inserts  whatever  string  l-MACS  bclic\es  comments  are 
supposed  to  start  with  (normally  ";").  If  the  line  goes  past  the  comment  column,  then  the  indentation  is  done 
to  a  suitable  boundary  (usually,  a  multiple  of  8).  If  the  language  you  arc  editing  requires  a  tciminator  for 
comments  (other  than  the  end  of  the  line),  the  terminator  is  inserted  too,  but  point  goes  between  the  starter 
and  the  terminator. 

Control-;  can  also  be  used  to- align  an  existing  comment.  If  a  line  already  contains  the  string  that  starts 
comments,  then  C-;  just  moves  point  after  it  and  indents  it  to  die  right  place  (where  a  comment  would  have 
been  created  if  there  had  been  none). 

liven  when  an  existing  comment  is  properly  aligned,  C-;  is  still  useful  for  moving  directly  to  the  start  of  the 
comment. 

C-M-;  CR  Kill  Comment)  kills  the  comment  on  the  current  line,  if  there  is  one.  The  indentation  before 
the  start  of  the  comment  is  killed  as  well.  If  there  docs  not  appear  to  be  a  comment  in  die  line,  nothing  is 
done.  Since  killed  text  can  be  reinserted  with  C-Y,  this  command  is  useful  for  moving  a  comment  from  one 
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20.5.1.  Multiple  Lines  of  Comments 

If  you  wish  to  align  a  large  number  of  comments,  you  can  give  Control-;  an  argument  and  it  indents  what 
comments  exist  on  that  many  lines,  creating  none.  Point  is  left  after  the  last  line  processed  (unlike  the 
no-argument  ease). 

When  adding  comments  to  a  long  stretch  of  existing  code,  the  commands  M-N  (~R  Down  Comment 
I  .ine)  and  M-P  (AR  Up  Comment  I  .inc)  may  be  useful.  They  are  like  C  N  and  C-P  except  that  they  do  a  C-; 
automatically  on  each  line  as  you  move  to  it,  and  delete  any  empty  comment  from  the  line  as  you  leave  it. 
Thus,  you  can  use  M-N  to  move  down  through  the  code,  putting  text  into  the  comments  when  you  want  to. 
and  allowing  the  comments  that  you  don’t  fill  in  to  he  removed  because  they  remained  empty. 

If  you  ate  typing  a  comment  and  find  that  you  wish  to  continue  it  on  another  line,  you  can  use  the 
command  Meta-J  or  Mcta-I .indeed  (AR  Indent  New  Comment  l  ine),  which  terminates  the  comment  you 
arc  typing,  creates  or  gobbles  a  new  blank  line,  and  begins  a  new  comment  indented  under  the  old.  one. 
When  Auto  fill  mode  is  on.  going  past  the  lill  column  while  typing  a  comment  causes  the  comment  to  be 
continued  in  just  this  fashion.  Note  that  if  the  next  line  is  not  blank,  a  blank  line  is  created,  instead  of  putting 
the  next  line  of  the  comment  on  the  next  tine  of  code.  To  do  that,  use  M-N. 

20.5.2.  Double  anti  Triple  Semicolons  in  Lisp 

In  l.i.sp  code  there  arc  conventions  for  comments  which  start  with  more  than  one  semicolon.  Continents 
which  start  with  two  semicolons  aic  indented  as  if  they  were  lines  of  code,  instead  of  at  the  comment  column. 
Comments  which  start  with  three  semicolons  arc  supposed  to  start  at  the  left  margin.  HMACS  understands 
these  conventions  by  indenting  a  double-semicolon  comment  using  lab,  and  by  not  changing  the  indentation 
of  a  triple-semicolon  comment  at  all.  (Actually,  this  rule  applies  whenever  the  comment  starter  is  a  single 
character  and  is  duplicated).  Note  that  the  :(g!  program  considers  a  four-semicolon  comment  a  subtitle  in 
l.ispcodc. 

20.5.3.  Options  Controlling  Comments 

The  comment  column  is  stored  in  the  variable  Comment  Column.  You  can  set  it  lo  a  number  explicitly. 
Alternatively,  the  command  C-X  ;  (AR  Set  Comment  Column)  sets  the  comment  column  to  the  column 
point  is  at.  C-U  C-X  ;  sets  the  comment  column  lo  match  the  last  comment  before  point  in  the  buffer,  and 
then  dues  a  Mela-;  to  align  the  current  line’s  comment  under  the  previous  one. 
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Many  major  modes  supply  def.iuli  local  values  for  the  comment  column,  in  addition,  C-X  ;  automatically 
makes  the  variable  Comment  Column  local.  Otherwise,  if  you  change  the  variable  itself,  it  changes  globally 
(for  all  buffers)  unless  it  has  been  made  local  in  the  selected  one.  See  section  22.6  [Locals],  page  1 18. 


Ilic  string  recognized  as  die  start  of  a  comment  is  stored  in  the  variable  Comment  Start,  while  the  string 
used  to  start  a  new  comment  is  kept  in  Comment  begin  (if  that  is  zero.  Comment  Shirt  is  used  for  new 
comments).  This  makes  it  possible  for  you  to  have  any  recognized  as  starting  a  comment  but  have  new 
comments  begin  with  ** 

The  string  used  to  end  a  comment  is  kept  in  the  variable  Comment  Knd.  In  many  languages  no  comment 
end  is  needed  as  the  comment  extends  to  the  end  of  the  line.  Then,  this  variable  is  a  null  siring. 


20.6.  Lisp  Mode  and  Muddle  Mode 

I  isp's  simple  syntax  makes  it  much  easier  for  an  editor  to  understand,  as  a  result,  KM  ACS  can  do  more  for 
Lisp,  and  with  less  work,  than  for  any  other  language. 

I  isp  programs  should  be  edited  in  f.isp  mode.  In  this  mode.  Tab  is  defined  to  indent  the  current  line 
according  to  the  conventions  of  Lisp  programming  style.  It  docs  not  matter  where  in  the  line  Tab  is  used;  the 
ePeet  on  the  line  is  the  same.  The  function  which  docs  the  work  is  called  ~R  Indent  fi>r  Lisp.  Linefeed,  as 
usual,  does  a  Return  and  a  Tab,  so  it  moves  to  the  next  line  and  indents  it. 

As  in  most  modes  where  indentation  is  likely  to  vary  from  line  to  line,  Ruhout  is  redefined  to  treat  a  tab  .is 
if  it  were  the  equivalent  number  of  space  (-R  Backward  Delete  I  lacking  labs).  Iliis  makes  it  possible  to  rub 
out  indentation  one  position  at  a  time  without  worrying  whether  it  is  made  up  of  spaces  or  tabs. 
Control-Rubout  does  the  ordinary  type  of  rubbing  out  which  rubs  out  a  whole  tab  at  once. 

Paragraphs  are  defined  to  start  only  with  blank  lines  so  that  the  paragraph  commands  can  be  useful.  Auto 
fill  indents  the  new  lines  which  it  creates.  Comments  start  with  In  Lisp  mode,  die  action  of  the 
word-motion  commands  is  affected  by  whether  you  arc  in  atom  word  mode  or  not 

The  I  KDIT  library  allows  KMACS  ind  Lisp  to  communicate,  telling  Lisp  die  new  definitions  of  functions 
which  you  edit  in  LMACS.  See  the  file  INTO;!  .KDIT  >. 

Hie  language  Muddle  is  a  variant  form  of  Lisp  which  shares  the  concept  of  using  parentheses  (of  various 
sorts)  as  the  main  syntactical  construct.  It  can  be  edited  using  Muddle  mode,  which  is  almost  the  same  as  I  .isp 
mode  and  provides  die  same  features,  differing  only  in  the  syntax  table  used. 
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20.6.1.  Moving  Over  and  Killing  Lists  and  S-expressions 


C-M-F' 

Move  Forward  over  s-expression. 

C-M-B 

Move  Backward. 

C-M-K 

Kill  s-expression  forward. 

C-M-Rubout 

Kill  s-expression  backward. 

C-M-U 

Move  Up  and  backward  in  list  structure. 

C-M-( 

The  same. 

C-M-) 

Move  up  and  forward  in  list  structure. 

C-M-D 

Move  Down  and  forward  in  list  structure. 

C-M-N 

Move  forward  over  a  list. 

C-M-P 

Move  backward  over  a  list 

C-M-T 

Transpose  s-expressions. 

C-M -(?»■ 

Put  mark  after  s-expression. 

M-( 

Pul  parentheses  around  nexts-cxprcssion(s). 

M-) 

Move  past  next  close  parenthesis  and  reindent. 

By  convention,  KM  ACS  commands  that  deal  with  balanced  parentheses  arc  usually  Control-Meta¬ 
characters.  They  tend  to  he  analogous  in  function  to  their  Control-  and  Meta-  equivalents.  'Ihese  commands 
arc  usually  thought  of  as  pci  mining  to  l  isp,  but  can  be  useful  with  any  language  in  which  some  sort  of 
parentheses  exist  (including  Knglish). 

To  move  forward  over  an  s-expression,  use  C-M-F  (~R  Forward  Scxp).  if  the  first  non-"uscless"  character 
after  point  is  an  C-M-F  moves  past  the  matching  If  the  first  character  is  a  C-M-F  just  moves  past 
it.  If  the  character  begins  an  atom,  C-M-F  moves  to  the  atom-break  character  that  ends  the  atom.  C-M-F 
with  an  argument  repeats  that  operation  the  specified  number  of  times;  with  a  negative  argument,  it  moves 
backward  instead. 

The  command  C-M-B  CR  Backward  Scxp)  moves  backward  over  an  s-expression;  it  is  like  C-M-F  with 

the  argument  negated.  If  there  arc -like  characters  in  front  of  the  s-expression  moved  over,  they  arc  moved 

over  as  well.  Thus,  with  point  after "  T'OO  ",  C-M-B  leaves  point  before  the  not  before  the  "F". 

These  two  commands  (and  most  of  the  commands  in  this  section)  do  not  know  how  to  deal  with  the 
presence  of  comments.  Although  that  would  he  easy  to  fix  for  forward  motion,  for  backward  motion  the 
syntax  of  l.isp  makes  it  ncaily  impossible.  Comments  by  themselves  wouldn’t  be  so  bad,  but  handling 
comments  and  "I"  both  is  impossible  to  do  locally.  In  a  line  "  ((FOO  ;  |  BAR  ",  arc  the  open  parentheses 
inside  of  a  "1  ...  atom?  I  do  not  think  it  would  be  advisable  to  make  C-M-F  handle  comments  without 
making  C-M-B  handle  them  as  well. 

For  this  reason,  two  other  commands  which  move  over  lists  instead  of  s-expressions  arc  often  useful,  ’llicy  * 

arc  C-M-N  (~R  Forward  I  .isl)  and  C-M-P  (~R  Backward  I  .ist).  They  act  like  C-M-F  and  C-M-B  except  that 
they  don't  stop  on  atoms;  after  moving  over  an  atom,  they  move  over  the  next  expression,  stopping  after 
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moving  over  a  lis:.  v*  itli  this  command,  you  can  avoid  stopping  after  all  of  the  words  in  a  comment. 

Killing  an  s-expression  at  a  time  can  be  done  with  C-M-K  and  C-M-Rubout  (~R  Forward  Kill  Sexp  and 
-R  Backward  Kill  Sexp).  C-M-K  kills  the  characters  that  C-M-K  would  move  over,  and  C-M-Rubout  kills 
what  C-M-B  would  move  over. 

C-M-F  and  C-M-B  stay  at  the  same  level  in  parentheses,  when  that’s  possible.  To  move  up  one  (or  n) 
levels,  use  C-M-(  or  C-M-)  [~R  Backward  Up  List  and  ~R  Forward  Up  List].  C-M-(  moves  backwards  up 
past  one  containing  "(".  C-M-)  moves  forwards  up  past  one  containing  ")”.  Given  a  positive  argument,  these 
commands  move  up  the  specified  number  of  levels  of  parentheses.  C-M-U  is  another  name  for  C-M-(,  which 
is  easier  to  type,  especially  on  non-Meta  keyboards.  If  you  use  that  name,  it  is  useful  to  know  that  a  negative 
argument  makes  the  command  move  up  forwards,  like  C-M-). 

To  move  down  in  list  structure,  use  C-M-D^R  Down  List).  It  is  nearly  the  same  as  searching  for  a  ”(". 

A  somewhat  random-sounding  command  which  is  nevertheless  easy  to  use  is  C-M-T  C'R  Transpose 
Sexps).  which  moves  the  cursor  fo-ward  over  one  s-expression.  dragging  the  previous  s-expression  along.  An 
argument  serves  as  a  repeat  count,  and  negative  argument  drags  backwards  (thus  canceling  out  the  effect  of 
a  positive  argument).  An  argument  of  mo.  rather  than  doing  nothing,  transposes  the  s-expressions  at  the 
point  and  the  mark 

To  make  the  region  be  the  next  s-expression  in  the  buffer,  use  orC-M-(«'  ("it  Mark  Sexp)  which  sets  mark 
at  the  same  place  that  C-M-F  would  move  to.  C-M-(?p  takes  arguments  like  C-M-F.  In  particular,  a  negative 
argument  is  useful  for  putting  the  mark  at  die  beginning  of  die  previous  s-expression. 

The  commands  M*(  [~R  Insert  ()j  and  M-)  (~R  Move  Over  )J  arc  designed  fora  style  of  editing  which 
keeps  paicnthcses  balanced  at  all  times.  M-(  inserts  a  pair  of  parentheses,  either  together  as  in  "()",  or,  if 
given  an  argument,  around  the  next  several  s-expressions,  and  leaves  point  after  the  open  parenthesis. 
Instead  of  typing  "(FOO)”,  you  can  type  M-(  FOO,  which  has  the  same  effect  except  for  leaving  the  cursor 
before  the  close  parenthesis.  'Ihcn  you  type  M-).  which  moves  past  the  close  parenthesis,  deleting  any 
indentation  preceding  it  (in  this  example  there  is  none),  and  indenting  with  I  .inefeed  after  it. 

The  list  commands’  understanding  of  syntax  is  completely  controlled  by  the  syntax  table.  Any  diameter 
can,  for  example,  he  declared  to  act  like  an  open  parenthesis.  See  section  22.4  |Syn(nx],  page  1 15. 


20.6.2.  Commands  for  Manipulating  Defuns 

C’-M-J,  C-M-A  Move  to  beginning  of  defun. 
C-M-J,  C-M-B  Move  to  end  of  defun. 

C-M-H  Put  region  a  ound  wl  lolc  defun. 
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In  KMACS,  a  list  al  the  top  level  in  the  buffer  is  ealted  a  deftin,  regardless  of  what  function  is  actually 
called,  because  such  lists  usually  call  defun.  'llicrc  arc  HM  ACS  commands  to  move  to  the  beginning  or  end 
of  the  current  defun:  C-M-{  ("R  Beginning  of  Deftin)  moves  to  the  beginning,  and  C-M-)  ("R  Knd  of 
Defun)  moves  to  the  end.  If  you  wish  to  operate  on  the  current  defun,  use  C-M-II  ("R  MaiK  Defun)  which 
puts  point  at  the  beginning  and  mark  at  the  end  of  the  current  or  next  defun.  Aherna.-  names  for  these  two 
commands  are  C-M-A  for  C-M-[  and  C-M-K  for  C-M-J.  "ITic  alternate  names  arc  easier  to  type  on  many 
non-Meta  keyboards. 

20.7.  Lisp  Grinding 

I  hc  best  way  to  keep  l  isp  code  indented  properly  is  to  use  KM  ACS  to  re-indent  it  when  it  is  changed. 
I-'MACS  has  commands  to  indent  properly  cither  a  single  line,  a  specified  number  of  lines,  oi  .ill  o*‘  the  lines 
inside  a  single  s-expression. 

Tab  In  I  .isp  mode,  reindents  line  according  to  parenthesis  depth. 

I  .inefeed  Ivqui valent  to  Return  followed  by  Tab. 

M-"  Join  two  lines,  leaving  one  space  between  them  if  appropriate. 

C-M-Q  Reindent  ail  the  lines  within  one  list. 

C-M-G  Grind  a  list,  moving  coue  between  lines. 

The  basic  indentation  function  is  "R  Indent  for  l.isp.  which  gives  the  current  line  the  correct  indentation 
;ls  determined  from  the  previous  lines’  indentation  and  parenthesis  structure.  Iliis  function  is  mutually  found 
on  C’-M-Tab,  but  when  in  Lisp  mode  it  is  placed  on  lab  as  well  (Use  Meta-Tab  tu  insert  a  tab).  When  given 
at  die  beginning  of  a  line,  it  leaves  point  alter  the  indentation;  when  given  inside  the  text  on  the  line,  point 
remains  fixed  with  respect  to  the  characters  around  iL 

When  entering  a  large  amount  of  new  code,  it  becomes  useful  that  Linefeed  ("R  Indent  New  Line)  is 
equivalent  toa  Return  followed  by  a  Tab.  In  Lisp  mode,  a  Linefeed  creates  or  moves  down  onto  a  blank  line, 
and  then  give  it  the  appropriate  indentation. 

To  join  two  lines  together,  use  the  Meta-"  or  Control-Meta-"  command  ("R  Delete  Indentation),  which  is 
approximately  the  opposite  of  Linefeed.  It  deletes  any  spaces  and  tabs  at  the  front  of  the  current  line,  and 
then  deletes  the  line  separator  before  the  line.  A  single  spare  is  then  inserted,  ir KMACS  thinks  that  one  is 
needed  there.  Spaces  arc  not  needed  before  a  close  parenthesis,  or  after  an  open  parenthesis. 

jf  you  arc  dissatisfied  about  where  Tab  wants  to  place  the  second  and  Inter  lines  of  an  s-expression.  you  can 
override  it.  If  you  alter  the  indentation  of  one  of  the  lines  yourself,  then  Tab  will  indent  successive  lines  of 
the  same  list  to  be  underneath  it.  'Iliis  is  the  right  thing  for  functions  which  'lab  indents  unacsthctically.  Of 
course,  it  is  the  wrong  thing  for  PROG  tags  (if  you  like  to  un-indent  them),  but  it’s  impossible  to  be  right  for 
both. 
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When  you  wish  to  re-indent  code  which  has  been  altered  or  moved  to  a  different  level  in  the  list  structure, 
you  have  several  commands  available.  You  can  re-indent  a  specific  number  of  lines  by  giving  the  ordinary 
indent  command  flab,  in  Lisp  mode)  an  argument.  'ITiis  indents  as  many  lines  as  you  say  and  moves  to  the 
line  following  them.  Thus,  if  you  underestimate,  you  can  repeat  the  process  later. 

You  can  re-indent  the  contents  of  a  single  s-expression  by  positioning  point  before  Hie  beginning  of  it  .and 
typing  Control-Mcta-Q  ("It  Indent  Sexp).  ’Hie  line  the  s-expression  starts  on  is  not  re-indented:  thus,  only 
the  relative  indentation  with  in  the  s-expression.  and  not  its  position,  is  changed.  To  correct  the  position  as 
well,  type  a  Tab  before  the  C-M-Q. 

Another  way  to  specify  the  range  to  be  re-indented  is  with  point  and  mark.  The  command  C-M-\ 
("R  indent  Region)  applies  fab  to  every  line  whose  first  character  is  between  point  and  mark.  In  l.isp  mode, 
this  does  a  l.isp  indent 

A  more  powerful  grind  command  which  can  move  text  between  lines  is  C-M-G  ("R  Format  Code).  You 
might  or  might  not  like  it.  It  knows  in  different  ways  about  l.isp  code  and  Maesyma  code. 

20.8.  Kiltling  Assembly* Language  Programs 

M-X  MIDAS  Mode  is  designed  for  editing  programs  written  in  MIDAS  or  other  I’DP-IO  or  PDP-11 
assemblers.  In  MIDAS  mode,  comments  start  with  and  “<"  and  have  the  syntax  of  parentheses.  In 
addition,  there  are  five  special  commands  which  understand  the  syntax  of  instructions  and  labels.  Ilicsc 
commands  arc: 

C-M-N  Go  to  Next  label. 

C-M-P  Go  to  Previous  label. 

C-M-A  Go  to  Accumulator  field  of  instruction. 

C-M-Ii  Go  to  Hffective  Address  field. 

C-M-D  Kill  next  word  and  its  Delimiting  character. 

M-{  Move  up  to  previous  paragraph  boundary. 

M-j  Move  down  to  next  paragraph  boundary. 

Any  line  which  is  not  indented  and  is  not  just  a  comment  is  taken  to  contain  a  label.  'Hie  label  is 
everything  up  to  the  first  whitespace  (or  the  cud  of  the  line).  C-M-N  ("It  Go  to  Next  Label)  and  C-M-P 
("R  Go  to  Previous  Label)  both  position  the  cursor  right  at  the  end  of  a  label;  C-M-N  moves  forward  or 
down  and  C-M-P  moves  backward  or  up.  At  the  beginning  of  a  line  containing  a  label,  C-M-N  moves  past  it. 
Past  the  label  on  the  same  line,  C-M-P  moves  back  to  (he  end  of  it.  If  you  kill  a  couple  of  indented  lines  and 
wan;  to  iuseil  ihom  rigid  after  a  label,  these  commands  pul  you  al  just  the  right  place. 

C-M-A  ("It  Go  to  AC  Field)  and  C-M-l:  ("It  Go  to  Address  Field)  move  to  the  beginning  of  the 
accumulator  (AC)  or  effective  address  fields  of  a  PDP-10  instruction.  They  always  slay  on  the  same  line. 
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moving  cither  forward  or  backward  as  appropriate.  If  die  instruction  contains  no  AC  field.  C-M-A  positions 
to  the  start  of  the  address  field.  If  the  instruction  is  just  an  opcode  with  no  AC  field  or  address  field,  a  space  is 
inserted  after  the  opcode  and  the  cursor  left  after  the  space.  In  PDP-1 1  programs,  C-M-A  moves  to  die. first 
operand  and  C-M-H  moves  to  die  second  operand. 

Once  you’ve  gone  to  the  beginning  of  the  AC  field  you  can  often  use  C-M-i)  (~R  Kill  terminated  Word) 
to  kill  the  AC  name  and  the  comma  which  terminates  it.  You  can  also  use  it  at  the  beginning  of  a  line,  to  kill 
a  label  and  its  colon,  or  after  a  line’s  indentation  to  kill  the  opcode  and  the  following  space.  This  is  very 
convenient  for  moving  a  label  from  one  line  to  another.  In  general,  C-M-D  is  equivalent  to  M-I)  C-D,  except 
that  all  the  characters  arc  saved  on  the  kill  ring,  together.  C-D.  a  "deletion"  command,  doesn’t  save  on  the 
kill  ring  if  not  given  an  argument. 

flic  M-(  and  M-J  commands  arc  not.  strictly  speaking,  redefined  by  MIDAS  mode,  since  they  always  go  up 
or  down  to  a  paragraph  boundary.  However,  in  MIDAS  mode  the  criterion  for  a  paragraph  boundary  is 
changed  by  setting  the  variable  Paragraph  Delimiter  (See  section  11.2  (Paragraphs!,  page  44.)  so  that  only 
blank  lines  (and  pages)  delimit  paragraphs.  So,  M-(  moves  up  to  the  previous  blank  line  and  M-j  moves  to  the 
next  one. 

20.9.  Major  Modes  .or  Ollier  Languages 

MACSYMA  mode  redefines  the  syntax  of  words  and  s -expressions  in  an  attempt  to  make  it  easier  to  move 
over  MACSYMA  syntactic  units.  In  addition,  the  C-M-G  "grind"  command  is  told  to  grind  text  as 
MACSYMA  instead  of  as  I  .isp.  Also,  the  syntax  of  MACSYMA  comments  is  understood. 

TFCO  mode  is  good  for  editing  1-MACS  library  source  files.  It  makes  'lab  be  ~R  Indent  Nested  (see  its 
seif-documentation).  Comments  start  with  ”!*  "  and  end  with  "I".  In  addition,  the  PURIFY  library  which 
contains  man)  things  useful  for  processing  library  sources  (including  the  commands  to  compile  them)  is 
loaded.  M-’  and  M-"  are  connected  to  functions  ~R  Forward  TFCO  Conditional  and  ~R  Backward  'I  FCO 
Conditional  which  move  forward  and  backward  over  balanced  TKCO  conditionals.  In  TFCO  inode  on  a 
terminal  with  a  Mela  key,  t  may  be  useful  to  set  the  TFCO  flag  FS  CTI.MTA*  which  causes  Control-Mcta 
commands  to  insert  Control  characters.  See  section  22.5  |FS  Flugsl,  page  1 17. 

PI  1  mode  is  for  editiug  PI  .1  code,  and  causes  Tab  to  indent  an  amount  based  on  the  previous  statement 
type.  The  body  of  the  implementation  of  PI. I  mode  is  in  the  library  Pl.l.  which  is  loaded  automatically  when 
necessary.  See  the  lilc  INFO.FPI.I  >. 

PASCAL  mode  is  similar  to  Pl.l  mode,  for  PASCAL  It  is  in  the  lihrarv  called  PASCAL  See  die  file 
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21.  The  TAGS  Package. 

The  TAGS  package  remembers  the  locations  of  the  function  definitions  in  a  fife  and  enables  you  to  go 
directly  to  the  definition  of  any  function,  without  searching.thc  whole  file. 

'Hie  functions  of  several  files  that  make  up  one  program  can  all  be  remembered  together  if  you  wish:  then 
die  TAGS  package  will  automatically  select  the  appropriate  file  as  well. 

21.1.  How  lo  Make  a  Tags  File  for  a  Program 

I  o  use  the  TAGS  package,  you  must  create  a  lag  table  for  die  text  file  or  files  in  your  package.  Normally, 
the  tag  table  docs  not  reside  in  any  of  those  files,  hut  in  a  separate  tag  table  tile  which  contains  the  names  of 
die  text  files  which  it  describes.  Tag  tables  arc  generated  by  the  :TAGS  program.  ITic  same  program  can  be 
used  to  update  the  tags  file  if  it  becomes  very  far  out  of  dale  (slight  inaccuracies  do  not  matter).  Tag  tables  for 
INI-’Q  files  woik  differently:  the  INFO  file  contains  its  own  tag  table,  which  describes  only  that  file.  See 
section  21.8  jiNF'O).  page  108.  for  bow  to  deal  with  them. 

Hie  normal  moi-c  of  operation  of  the  :TAGS  program  is  to  read  in  an  existing  tags  file  and  update  it  by 
rescanning  the  source  files  that  it  describes.  'Hie  old  tag  table  file  itself  tells  :TAGS  which  source  files  to 
process.  When  making  a  new  tag  table  you  must  start  by  making  a  skeleton.  Then  :TAGS  is  used  to  tom  the 
skeleton  into  an  accurate  tag  table. 

A  skeleton  tag  table  is  like  a  real  one  except  that  it  is  empty:  there  arc  no  tags  in  iL  It  contains  cx;tclly  this 

much  data,  for  each  source  file  that  it  is  going  to  describe: 

<f ilenaraes> 

0, <1anguage> 

t_ 

lire  languages  that  TAGS  understands  now  arc  TTCO,  LISP.  MIDAS.  FAIL  PAI.X.  MUDDI.F, 
MAC  S  i'MA,  TJ6.  and  R.  MIDAS  will  do  for  MACRO-IO  files.  Any  incompletely  specified  filenames  will 
default  to  >  and  to  the  directory  on  which  the  lags  file  ilscir  is  stored,  'lire  "0."  must  he  present,  since  .'TAGS 
expects  that  there  will  be  a  number  in  that  place  anil  will  lie  completely  confused  if  there  is  not.  'lire  CRI.F 
after  each  t_  also  must  he  present.  You  can  omit  both  the  last  r_  and  its  CKI.F  together,  however. 


'Ilurs.  a  skeleton  tags  file  for  die  files  F’MACS:USRCOM  >  and  HMACS:TAGS  >  would  look  like 
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EHACS:USRC0M  > 

0.TEC0 

t_ 

EHACS;TAGS  > 

O.TECO 

t_ 

If  this  were  written  out  as  KMACS:KM  ACS  TAGS,  you  could’thcn  do 
:TAGS  EMACS: EMACS  (default  FN2  is  TAOS) 

which  would  tell  :TAGS  to  read  in  the  lags  file,  and  write  back  an  up-to-date  tags  file  for  she  same  set  of 
source  files.  To  update  the  tags  file  because  lots  of  changes  have  been  made,  the  same  command  to  the 
:T \GS  program  will  work.  See  section  2 1 .6  jKdilj.  page  106.  for  info  on  adding,  deleting,  or  renaming  files  in 
existing  tags  files. 

21.2.  How  to  Tel!  EMACS  You  Want  to  Use  TAGS 

Before  you  can  tsse  the  TAGS  package,  you  must  tell  KMACS  Gsc  name  of  the  tags  file  you  want  to  use. 
"Hits  is  done  with  the  command 

M-X  Visit  Tag  Tabled  <filenames>  <cr> 

The  J;N2of  "TAGS**  need  not  be  mentioned. 

KM  ACS  can  only  know  about  one  tag  table  file  at  a  time,  sir  doing  a  second  M-X  Visit  Tag  Table  causes 
the  first  one  to  he  forgotten  (or  written  back  if  you  have  added  definitions  to  it). 

Giving  M-X  Visit  Tag  Table  a  nonzero  numeric  argument,  as  in 
1  M-X  Visit  Tag  Tabled  <filenames>  <cr> 
has  the  additional  eficct  of  setting  the  variable  Tags  Kind  Kile  nonzero,  which  causes  the  TAGS  package  to 
use  Mud  Kile  rather  than  Visit  Kile  when  it  needs  to  switch  files.  Tliis  causes  all  the  files  to  remain  resident  in 
die  KM  ACS.  in  different  buffers,  in  the  default  mode,  visiting  a  tag  in  a  different  file  read  it  in  or,  top  of  the 
old  file,  in  the  same  buffer  (but  i'  offers  to  write  out  changes  if  there  arc  any).  Wanting:  yen:  can  easily  run 
out  of  ..vldrcss space  by  making  too  many  buffers,  this  way. 

Visit  Tag  Table  is  essentially  equivalent  lo  selecting  the  buffer  "■’TAGS*”  and  visiting  the  lag  table  file  in 
linn  buffer,  then  reluming  lo  the  previously  selected  hulfcr.  Afterwards,  M-X  list  Bulfcrs  will  show  the 
hufTcr  *TAGS*  visiting  that  file.  'Hie  only  difference  is  that  M-X  Visit  Tag  Table  causes  lire  out  of  cere 
portions  of  the  TAGS  package  to  he  loaded. 
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21.3.  Jumping  to  a  Tag 

To  jump  to  the  definition  of  a  function,  use  the  command  Meta-Period  <tag  namc>  <cr>.  You  will  go 
straight  to  the  definition  of  the  tag.  If  the  definition  is  in  a  different  file  then  TAGS  will  visit  that  file.  If  it  is 
in  the  same  file,  TAGS  will  leave  the  mark  behind  and  print  in  the  echo  area. 

If  Meta-Period  is  used  before  M-X  Visit  Tag  Table  has  been  done,  it  will  ask  for  die  name  of  a  tag  table 
file.  After  you  type  dtis  name  and  a  <cr>,  you  type  the  name  of  the  tag  as  usual. 

You  do  not  need  to  type  the  complete  name  of  the  function;  any  substring  will  do.  But  this  implies  that 
sometimes  you  won’t  get  the  function  you  intended.  When  that  happens.  C-U  Meta-Period  will  find  the 
"next"  function  matching  what  you  typed  (next,  in  the  order  of  listing  in  the  tag  table).  Iluis,  if  you  wanted 
to  find  the  definition  of  X-SHT-TYPIH  and  you  said  just  TY PH-1,  you  might  find  X-RFAD-TYPIH  instead. 
You  could  then  type  C-U  Meta-Period’s  until  you  reached  X-SFT-TYPB-1. 

If  you  want  to  make  sure  you  reach  a  precise  function  the  first  time,  you  should  just  include  a  character  of 
context  bcfoie  and  after  its  name.  Thus,  in  a  l  isp  program,  put  a  space  before  and  after  the  function  name. 
In  a  M  IDAS  program,  put  a  linefeed  before  it  and  a  colon  after. 

21.4.  Other  Operations  on  Tag  Tables 

21.4.1.  Adding  a  New  Function  to  a  Tag  Table 

When  you  define  a  new  function,  its  location  doesn't  go  in  the  tag  table  automatically.  That’s  because 
KMACS  can't  tell  that  you  have  defined  a  function  unless  you  issue  the  command  to  say  so  by  invoking  the 
function  AR  Add  Tag.  Since  the  operation  of  adding  a  tag  to  a  tag  table  has  proved  not  to  be  very  necessary, 
this  function  no  longer  placed  on  any  character,  by  default.  You  can  invoke  with  M-X  or  place  on  a  key  if 
you  like.  From  this  section,  let’s  assume  you  have  placed  it  on  C-X  Period. 

When  you  type  the  command  C-X  Period,  the  pointer  should  be  on  the  line  that  introduces  the  function 
definition,  alter  the  function  name  and  the  punctuation  that  ends  it.  Thus,  in  a  l.isp  piogram,  you  might  type 
"(Dlvl-'UN  FOO  "  (note  the  space  alter  FOO)  and  then  type  the  C-X  Period.  In  a  MIDAS  program,  you 
might  give  the  C-X  Period  alter  typing  "FOO:".  In  a  THCO  program  in  HMACS  format,  you  might  type  C-X 
Peiiod  after  "ISct  New  Foo:!". 

C-X  Period  modifies  only  the  copy  of  the  tag  table  loaded  into  FM  ACS.  To  modify  the  tag  table  file  itself, 
you  must  cause  it  to  be  written  out.  Do  this  by  selecting  the  buffer  *TAGS*  and  saving  it  with  C-X  C-S,  or 
with  M-X  Save  All  Files.  There  is  also  a  function  M-X  ?  Save  lag  Table  for  doing  it. 
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Although  local  modifications  to  a  file  do  not  degrade  the  efficiency  of  the  TAGS  package  or  require  that 
the  tag  table  be  updated  with  :TAGS,  moving  a  function  a  great  distance  make  make  it  much  slower  to  find 
that  function.  In  this  ease,  you  can  "add"  the  function  to  the  tag  table  with  C-X  Period  to  give  the  table  its 
new  location.  Or  you  can  just  run  :TAGS  again  to  update  everything,  as  is  usually  done. 


t 

21.4.2.  1  low  to  Process  AH  the*  Files  in  a  Tag  Table 

The  TAGS  package  contains  a  function  M-X  Next  File  which  visits,  one  by  one,  all  the  files  described  by 
the  selected  tag  table.  This  is  useful  when  there  is  something  to  be  done  to  all  of  the  files  in  the  package.  To 
start  off  the  sequence,  do  C  U  1  M-X  Next  File,  which  visits  the  first  file.  When  you  are  finished  operating 
on  one  file,  do  M-X  Next  File  (no  argument)  to  see  the  next.  When  all  the  files  have  been  processed,  M-X 
Next  File*  gives  an  error. 

The  files  of  the  package  arc  visited  in  the  order  that  they  arc  mentioned  in  the  tag  table,  and  the  current 
place  in  the  sequence  is  remembered  by  the  pointer  in  the  buffer  "TAGS*  which  holds  the  tag  table.  'Ilius,  if 
you  wsit  a  tag  in  a  different  file  in  the  middle  of  a  M-X  Next  File  sequence,  you  will  screw  it  up  unless  you 
return  to  the  proper  file  again  by  visiting  a  tag  (or  go  into  the  buffer  *TAGS*  and  reset  the  pointer). 
However,  visiting  any  other  files  directly,  not  using  TAGS,  does  not  interfere  with  the  sequence,  and  the  next 
M-X  Next  File  will  go  just  where  it  would  have  gone. 

Next  File  is  also  useful  as  a  subroutine  in  functions  that  wish  to  perform  an  automatic  transformation  (such 
as  a  Query  Replace)  on  each  file.  Such  functions  should  call  Next  File  with  a  prccomina  argument  as  in 
l,M(M.M  Next  File*)  nr  1,!M(M.M  Next  File*).  The  prccomina  argument  tells  Next  File  to  return  0  instead 
of  giving  an  error  when  there  arc  no  more  files  to  process.  Normally,  it  returns  -1. 

1  lerc  is  an  example  ofTRCO  code  to  do  a  Query  Replace  on  all  of  the  files  listed  in  the  visited  tag  table: 

1M(M.M  Next  File*) 

<  M ( M . M  Query  Repl ace*)r00*BAR* 

1 ,M(M.M  Next  File*);> 

l  ags  Search  and  Tags  Query  Replace  (see  bciow)  both  work  using  Next  File. 

21.4.3.  Multi-File  Searches  and  Replacements 

The  TAGS  package  contains  a  function  'lags  Search  which  will  search  through  all  of  the  files  listed  in  the 
visited  tag  table  in  the  order  they  arc  listed.  Do  M-X  Tags  Search*<siringXcr>  to  find  every  occurrence  of 
<string>.  <strit”>  is  a  TKCO  scat  eh  string  in  which  special  TFCO  search  characters  such  as  tO,  fX,  f  N.  tH, 
and  tQ  are  allowed.  See  section  19.3  [TFCO  Search  Strings],  page  85. 
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When  M-X  'lags  Scarcli  reaches  the  end  of  the  buffer,  it  visits  the  next  file  automatically,  typing  its  name 
in  the  echo  area.  As  soon  as  M-X  l  ags  Search  finds  one  occurrence,  it  returns.  But  it  defines  the  command 
Control-Period  to  resume  the  search  from  wherever  point  is. 

Warning:  use  of  Tags  Search  after  setting  Tags  Find  File  to  1  can  create  more  buffers  than  KM  ACS  can 
handle.  'Iliis  results  in  an  URK  "Running  out  of  core"  error.  After  the  error,  you  might  be  at  TKCO 
command  level,  outside  of  1-MACS.  If  your  type-in  is  echoed  at  the  bottom  of  the  screen,  this  has  happened. 
You  should  immediately  type  MM  Kill  Some  Buffers**,  kill  some,  and  then  do  :M..I.**  to  reenter  F.MACS. 

M-X  Tags  Query  Replace  docs  a  Query  Replace  over  all  the  files  in  a  tag  table.  Like  M-X  l  ags  Search,  it 
sets  Control-,  up  to  be  a  command  to  continue  the  Query  Replace,  in  case  you  wish  to  exit,  do  some  editing, 
and  then  resume  scanning. 

The  library  MQRKPL  enables  you  to  use  Next  File  to  repeat  a  sequence  of  many  Query  Replace 
commands  over  a  set  of  files,  performing  all  the  replacements  on  one  file  at  a  time. 

21.4.4.  Miscellaneous  Applications  of  Tags 

M-X  I  isl  T;igs*<filcXcr>  lists  all  the  lags  in  the  specified  file.  Actually,  all  the  files  in  the  tag  table  whose 
names  contain  the  sti  ing  <filc>  arc  listed. 

M-X  Tags  Apropos*<patXcr>  lists  all  known  tags  whose  names  contain  <pat>. 

M-X  Tags  File  List  inserts  in  the  buffer  a  list  of  the  files  known  in  the  visited  tag  table. 

M-X  Tags  Rescan  runs  :TAGS  over  the  visited  tag  table  and  revisits  it.  'Iliis  is  the  most  convenient  way  to 
update  the  tag  table. 

M-X  View  Arglist*<tagXcr>  lets  you  look  briefly  at  the  line  on  which  a  tag  is  defined,  and  at  the  lines  of 
comments  which  precede  the  definition.  'Iliis  is  a  good  way  to  find  out  what  arguments  a  function  needs. 
The  file  is  always  loaded  into  a  separate  buffer,  when  this  command  is  used. 

M-X  What  Tag?  tells  you  which  f*  action's  definition  you  arc  in.  It  looks  through  liic  tag  table  for  the  lag 
which  most  nearly  precedes  point. 

21.5.  YVlial  (  onslii tiles  ;i  Tug 

In  Lisp  code,  a  function  definition  must  start  with  an  "("  at  the  beginning  of  a  line,  followed  immediately 
with  an  atom  which  starts  with  "OFF"  (and  docs  not  start  with  "DKFP"),  or  which  stalls  with  "MACRO",  or 
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which  starts  with  "HNDF".  'Ihc  next  atom  on  the  line  is  the  name  of  the  tag.  If  there  is  no  second  atom  on 
the  line,  there  is  no  tag. 

In  MIDAS  code,  a  tag  is  any  symbol  that  occurs  at  the  beginning  of  a  line  and  is  terminated  with  a  colon  or 
an  equal  sign.  MIDAS  mode  is  good  for  MACRO-10  also. 

I;A  1 1,  code  is  like  MIDAS  code,  except  that  one  or  two  i’s  or  "~"’s  arc  allowed  before  a  tag,  and  spaces  are 
allowed  between  the  tag  name  and  the  colon  or  equal  sign,  and  _  is  recognized  as  equivalent  to  = . 

FALX  code  is  like  MIDAS  code,  except  that  spaces  arc  allowed  between  a  tag  and  the  following  colon  or 
equals,  and  local  tags  such  as  "10$"  arc  ignored. 

In  TFCO  code,  a  tag  starts  with  an  "!”  and  ends  with  a  There  may  be  tiny  number  of  tags  on  a  line, 
but  the  first  one  must  start  at  the  beginning  of  a  line. 

In  MUDDI.F  code,  a  tag  is  identified  by  a  line  that  stalls  with  "<DIT'INH  *  or  "<DHFMAC  ",  followed 
by  a  symbol. 

In  MACSYMA  code,  a  function  definition  is  recognized  when  there  is  a  symbol  at  the  beginning  of  a  line, 
terminated  with  a  "("  or  "[",  and  there  is  a  later  on  in  the  line.  If  the  symbol  itself  is  terminated  with  a 
a  variable  definition  is  recognized. 

In  R  text,  any  line  which  starts  with  ".dc"  or  ".am"  or  ".rtag"  defines  a  tag.  The  name  of  the  tag  is  what 
follows,  up  to  die  second  run  of  spaces  or  the  end  of  the  line.  There  is  no  ".rtag"  in  R;  define  it  to  be  a  null 
macto,  if  you  like,  and  use  it  to  put  in  tags  for  chapters,  or  anything  else.  Any  macro  whose  name  starts  with 
"de"  or  "am"  or  "rtag",  such  as  ".define"  or  ".amplify",  also  defines  a  lag. 

In  TJ(i  text,  any  line  which  starts  with  ”.CTAG"  starts  a  tag.  The  name  of  the  tag  is  whatever  follows  the 
spaces  which  should  follow  die  "C  TAG",  up  to  the  next  space  or  the  end  of  the  line. 

21.6.  Adding  or  Removing  Source  Files 

A  tag  table  file  is  a  sequence  of  entries,  one  per  file.  I  itch  entry  looks  like 

<f i lenames> 

<count> , <1anguage> 

<data  lines> 

j 

{.filenames)  arc  the  fully  defaulted  names  of  the  file,  <ianguagc>  is  one  of  the  languages  that  'TAGS  knows 
how  to  process,  and  <dala  lines)  are  the  actual  tag  information  (described  below).  'Die  CRI.F  after  each  t_ 
must  be  present.  You  can  omit  both  the  last  t_  and  its  CRI.F'  together,  however. 
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A  tags  Hie  is  for  the  most  part  an  ordinary  ASCII  file,  and  any  changes  you  make  in  it,  including  changes  to 
the  source  files’  names,  will  do  what  they  appear  to  do. 

Hie  one  exception  is  that  each  entry  contains  a  count,  in  decimal,  of  the  number  of  characters  in  it 
including  the  t_  and  CRI.F.  If  you  edit  the  contents  of  an  individual  source  file’s  entry,  and  change  its 
length,  then  the  tags  file  is  no  good  for  use  in  editing  until  you  run  :TAGS  over  it.  :TAGS  ignores  the 
specified  count  and  always  writes  the  correct  count.  If  you  are  sure  that  the  length  is  unchanged,  or  if  you 
change  the  count  manually,  then  running  .'TAGS  is  not  necessary,  but  you  do  so  at  your  own  risk.  If  you 
screw  things  up.  use  r'l'AGS  to  fix  the  file. 

nius.  if  you  arc  changing  a  source  file’s  name,  you  should  simply  change  the  name  where  it  is  present  in 
the  tags  file,  and  rr:i  :TAGS  over  it  if  necessary. 

To  add  a  new  source  file,  simply  insert  a  dummy  entry  of  the  sort  used  in  making  a  new  lags  file.  Then  use 
TAGS  to  turn  it  into  a  real  entry.  Unless  you  go  to  the  trouble  of  putting  a  valid  count  in  the  dummy  entry, 
you  must  run  :TAGS  again  before  using  the  file. 

You  can  delete  a  source  file  from  a  tags  file  by  deleting  its  entire  entry.  You  can  also  change  llic  order  of 
die  entries  without  doing  any  harm  (the  order  of  die  entries  doesn’t  matter  very  often).  Since  the  counts  of 
the  remaining  entr'es  arc  still  valid,  you  need  not  run  TAGS  over  the  file  again. 

You  can  edit  everything  else  in  the  tags  file  loo,  if  you  want  to.  You  might  want  to  change  a  language 
name  once  in  a  while,  but  1  doubt  you  will  frequently  want  to  add  or  remove  tags,  especially  since  that  would 
all  be  undone  by  the  next  use  of  :TAGS! 


21.7.  How  a  Tag  Is  Described  in  the  Tag  Table 

A  tag  table  file  consists  of  one  or  more  subunits  in  succession.  Kach  subunit  lists  the  tags  of  one  source  file. 
Hath  subunit  has  the  overall  format  described  in  die  previous  section,  containing  zero  or  more  lines 
describing  tags.  Here  we  give  the  format  of  cacli  of  those  lines. 

Starting  with  the  diird  line  of  the  tag  table  entry,  each  line  describes  a  tag.  It  starts  with  a  copy  of  the 
beginning  of  the  line  that  the  tag  is  defined  on,  up  through  the  tag  name  and  its  terminating  punctuation. 
Then  there  is  a  rubout,  followed  by  the  character  position  in  decimal  of  the  place  in  the  line  where  copying 
stopped,  l-'or  example,  if  a  line  in  a  MIDAS  program  starts  with  "KM):"  and  the  colon  is  the  602nd 
character  in  the  file,  then  die  line  describing  it  in  the  tag  table  would  be 


I  M 


. . . 
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F00: <rubout>603 

One  line  can  describe  sc\eral  lags,  if  they  arc  defined  on  the  same  line;  in  fact,  in  that  ease,  they  must  be 
on  the  same  line  in  the  tag  table,  since  it  must  contain  everything. before  the  tag  name  on  iLs  definition  line. 
For  example, 

!Foo:l  ! Bar : ! 

in  a  file  of  I’F.CO  code  followed  by  character  number  500  of  the  file  would  turn  into 
! Foo : !  !Bar : ! <rubout>500 

KMACS  will  be  able  to  use  that  line  to  find  either  FOO  or  BAR,  :TAGS  knows  how  to  create  such  things 
only  for  TF.CO  files,  at  the  moment.  They  aren’t  necessary  in  l.isp  or  MACSYMA  files.  In  MIDAS  files, 
TAGS  simply  ignores  all  but  the  first  tag  on  a  line. 


21.8.  Tag  Tables  for  INFO  Structured  Documentation  Fifes 

INFO  files  arc  divided  up  into  nodes,  which  the  INFO  program  must  search  for.  Tag  tables  for  these  files 
are  designed  to  make  the  INFO  program  run  faster.  Unlike  a  normal  t.ig  table,  the  lag  table  for  an  INFO  file 
resides  in  that  file  and  describes  only  that  file.  Ibis  is  so  that  INFO,  when  visiting  a  file,  can  automatically 
use  its  tag  table  if  it  hits  one.  INFO  uses  the  tag  tables  of  INFO  files  itself,  without  going  through  the  normal 
TAGS  package,  which  has  no  knowledge  of  INFO  file  tag  tables,  lints,  INFO  file  tag  tables  and  normal  ones 
resemble  each  other  only  in  their  appearance,  and  dial  for  convenience  the  same  :TAGS  program  generates 
both.  In  use,  they  are  unrelated  to  each  other. 

To  create  a  tag  table  in  an  INFO  file,  you  must  first  put  in  a  skeleton.  T  his  skeleton  must  be  very  close  to 
the  end  of  the  file  (at  most  8  lines  nitty  follow  it,  or  INFO  will  not  notice  it),  and  it  must  start  on  the  line 
following  a  t_  or  t_tl.  which  ends  a  node.  Its  format  is  as  follows: 

t_tL 

Tag  Table: 

t_ 

End  Tag  Table 

No  nodes  may  follow  the  lag  table,  or  :TAGS  will  not  put  them  in  it.  :TAGS  is  one  pass  and  after  writing 
the  tag  table  into  the  file  it  copies  the  rest  of  the  inpiitTilc  with  no  processing. 

To  turn  the  skeleton  into  the  real  thing,  or  to  update  the  tag  table,  run  :TAGS  on  the  file  and  specify  the  /I 
switch,  as  in 
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:TAGS  INFO ; EMACS/I 

:TAGS  will  process  the  file  and  replace  the  old  tag  table  or  skeleton  with  an  up-to-date  tag  table.  'Hie  /I 
identifies  die  specified  file  as  an  INFO  file  rather  than  a  tag  table  file.  Also,  it  makes  the  default  FN2  ">” 
rather  than  the  usual  "TAGS". 

Once  the  tag  table  is  constructed.  INFO  will  automatically  make  use  of  iL  A  tag  in  an  INFO  file  is  just  a 
node;  whatever  follows  "Node:"  on  a  line  whose  predecessor  contains  a  "t_"  is  taken  to  be  a  tag.  'Ilic 
charactci  which  terminates  the  node  name,  which  may  be  a  comma,  tab,  or  CKi.F,  is  not  included  in  the  tag 
table.  Instead,  the  rubout  comes  right  after  the  tag  name.  'Fhis  is  to  make  it  easy  for  INFO  to  demand  an 
exact  match  on  node  names,  rather  than  the  substring  match  which  the  TAGS  package  normally  uses. 

Tag  tables  in  INFO  files  must  be  kept  close  to  up  to  date.  INFO  will  not  find  the  node  if  its  shut  has 
moved  more  than  1000  characters  before  the  position  listed  in  the  tag  table.  For  best  results,  you  should 
update  an  INFO  file’s  tag  table  every  time  you  modify  more  than  a  few  characters  of  it 
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22.  Simple  Customization 

In  'Jus  chapter  we  describe  the  many  simple  ways  of  customizing  KM  ACS  without  knowing  how  to  write 
TKCO  programs. 

22.1.  Minor  Modes 

Minor  modes  are  options  which  you  can  use  or  not.  They  are  all  independent  of  each  other  and  of  the 
selected  major  mode.  Most  minor  modes  say  in  the  mode  line  when  they  arc  on.  See  section  1.1  (Mode  Line), 
page  6.  l-aclt  minor  mode  is  the  name  of  the  function  that  car.  he  used  to  turn  it  on  or  tiff.  With  no  argument, 
die  function  turns  the  mode  on  if  it  was  off  and  off  if  it  was  on.  This  is  known  as  "toggling".  A  positive 
argument  always  turns  the  mode  on,  and  jin  explicit  zero  argument  or  a  negative  argument  always  tut  ns  it  off. 
All  the  minor  mode  functions  are  suitable  for  connecting  to  single  or  double  character  commands  if  you  want 
to  enter  and  exit  a  minor  mode  frequently. 

Auto  Kill  mode  allows -you  to  type  text  endlessly  without  worrying  about  the  width  or  your  screen.  Line 
separators  are  be  inserted  where  needed  to  prevent  lines  from  becoming  too  long.  'Ihe  column  at  which  lines 
arc  broken  defaults  to  70.  but  you  can  set  it  explicitly.  C-X  K  (~R  Set  l-'ill  Column)  sets  the  column  for 
breaking  lines  to  the  column  point  is  at:  or  you  can  give  it  a  numeric  argument  which  is  the  desired  column. 
TJic  value  is  stored  in  the  variable  Fill  Column. 

Auto  Save  mode  protects  you  against  system  crashes  by  periodically  saving  the  Tile  you  arc  visiting. 
Whenever  you  visit  a  file,  auto  saving  is  enabled  if  Auto  Save  Default  is  nonzero;  in  addition,  M-X  Auto  Save 
allows  you  to  turn  auto  saving  on  or  offin  a  given  buffer  at  any  time.  Sec  section  13.3  (Auto  Save),  page  57. 

Atom  Word  mode  causes  the  word-moving  commands,  in  1  .isp  mode,  to  move  over  1  .isp  atoms  instead  of 
words.  Some  people  like  this,  and  others  don’t.  In  any  case,  the  s-expression  motion  commands  can  he  used 
to  move  over  atoms.  If  you  like  to  .  use  -  segmented  atom  names  like 
FOOIlAU-RI'AD-IN-NI'Xr-INPUr-.SOUKCK-TO-RIvAD,  then  you  might  prefer  not  to  use  Atom  Word 
mode,  so  that  you  can  use  M-F  to  move  over  just  part  of  the  atom,  or  C-M-K  to  move  over  the  whole  atom. 

Overwrite  mode  causes  ordinary  printing  characters  to  replace  existing  text  instead  of  shoving  it  over.  It  i$ 
good  for  editing  pictures.  For  example,  if  the  point  is  in  front  of  the  H  in  FOOI1AR,  then  in  Overwrite  mode 
typing  a  G  changes  it  to  F'OOGAR,  instead  of  making  it  FOOGHAR  as  usual.  Also.  Ruboul  is  changed  to 
turn  the  previous  character  into  a  space  instead  of  deleting  it. 

Word  Abbrev  mode  allows  you  to  define  abbreviations  that  automatically  expand  as  you  type  them.  For 


112 


l-MACS  Manual  for  l'l  S  Users 


example,  "wain"  might  expand  to  "word  abbrev  mode".  'Hie  abbreviations  may  depend  on  the  major  (e.g. 
Lisp.  Text. ...)  mode  you  arc  currently  in.  To  use  this,  you  must  load  the  WORDAB  library.  See  section  25 
(Wordabj,  page  141. 

Indent  labs  mode  controls  whether  indentation  commands  use  tabs  and  spaces  or  just  spaces  to  indent 
with.  Usually  they  use  both,  but  you  might  want  to  use  only  spaces  in  a  file  to  be  processed  by  a  program  or 
system  which  doesn’t  ignore  tabs,  or  for  a  file  to  be  shipped  to  a  system  like  Multics  on  which  tab  stops  arc 
not  every  8  characters. 

Most  minor  modes  arc  actually  controlled  by  variables.  The  mode  is  on  if  the  variable  is  nonzero.  Setting 
the  minor  mode  with  a  command  works  by  changing  the  variable.  Ibis  means  that  you  can  turn  the  modes 
on  or  off  with  lidit  Options,  or  make  their  values  local  to  a  buffer.  See  section  22.3  (Variables],  page  1 14. 

You  could  also  pul  a  minor  mode  in  the  local  inodes  list  of  a  file,  but  that  is  usually  had  practice.  Ibis  is 
because  usually  the  preference  for  a  minor  mode  is  usually  a  matter  of  individual  style  rather  that  a  property 
of  the  file  per  sc.  To  make  this  more  conciete.  it  is  a  property  of  a  file  that  it  be  filled  to  a  certain  column,  but 
use  of  auto  fill  mode  to  accomplish  that  is  a  matter  of  taste.  Sc  it  would  be  good  practice  for  the  file  to  specify 
the  value  of  l-'ill  Column,  but  bad  practice  for  the  file  to  specify  the  value  of  Auto  l-'ill  Mode. 

If  you  find  yourself  constantly  tempted  to  put  Auto  l-’ill  Mode  in  local  modes  lists,  what  you  probably 
really  want  is  to  have  Auto  l-'ill  mode  on  whenever  you  are  in  Text  mode.  Ibis  can  be  accomplished  with  the 
following  code  in  an  HVARS  file: 

Text  Mode  Hook:  lM.LAuto  Fill  Mode$ 

Suffice  it  to  explain  that  this  is  TLCO  code  to  be  executed  whenever  Text  mode  is  entered,  which  makes  die 
variable  Auto  l-’ill  Mode  local  to  the  buffer  with  local  value  l. 

22.2.  Libraries  of  Commands 

All  I’M  ACS  functions,  including  the  ones  described  in  this  document,  reside  in  libraries.  A  function  is  not 
accessible  unless  the  library  that  contains  it  is  loaded,  livery  liMACS  starts  out  with  one  library  loaded:  the 
liMACS  library.  ’Ibis  contain  <•!!  of  the  functions  described  in  this  document,  except  those  explicitly  stated  to 
be  elsewhere.  Other  libraries  arc  provided  with  liMACS,  and  can  be  loaded  automatically  or  on  request  to 
make  their  functions  available.  See  section  (Catalogue],  page  1 85,  for  a  list  of  them. 

To  load  a  library  permanently,  say  M-X  Load  l.ibrarvKIibnamcXcrX  'Ibe  library  is  found,  either  on  your 
own  directory  or  whichever  one  you  specify,  or  on  die  liMACS  directory,  and  loaded  in.  All  the  functions  in 
the  library  are  then  available  for  use.  Whenever  you  use  M-X,  die  function  name  you  specify  is  looked  up  in 
each  of  the  libraries  which  you  have  loaded,  more  recently  loaded  libraries  first.  ’Ibe  first  definition  found  is 
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the  one  that  is  used. 

l-or  example,  if  you  load  the  PICI'IIRH  library,  you  can  then  use  M-X  Kdit  Picture  to  run  the  Kdit  Picture 
function  which  exists  in  that  library. 

In  addition  to  making  functions  accessible  to  M-X,  the  library  may  connect  some  of  them  to  command 
characters. 

You  can  also  load  a  library  temporarily,  just  long  enough  to  use-  one  of  the  functions  in  it.  'Ibis  avoids 
taking  up  space  permanently  with  the  library.  Do  this  with  the  function  Run  Library,  as  in  M-X 
RunXl:bnamc>Kfunction  nameXerX  ‘Ibc  library  <libname>  is  loaded  in.  and  <function  name>  executed. 
Then  the  library  is  removed  from  the  KM  ACS  job.  You  can  load  it  in  again  later. 

M-X  List  Loaded  Libraries  types  the  names  and  brief  descriptions  of  all  the  libraries  loaded,  last  loaded 
first.  Ibe  last  one  is  always  the  I  {MACS  library.  You  can  get  a  description  of  all  the  functions  in  a  library 
with  M-X  List  LibraryKIibnamcXcrX  whether  the  library  is  loaded  or  not. 

'Die  function  Kill  Libraries  can  be  used  to  discard  libraries  loaded  permanently  by  Load  Library. 
(Libraries  used  with  Run  I  .ibrary  are  discarded  automatically).  I  lowever,  of  all  the  libraries  presently  loaded, 
only  the  most  recently  loaded  one  can  be  discarded.  Kill  Libraries  offers  to  kill  each  loaded  library,  most 
icccnily  loaded  first.  It  keeps  killing  libraries  until  you  say  to  keep  one  library.  'Ilien  it  returns,  because  lltc 
remaining  libraries  cannot  be  deleted  if  that  library  is  kept. 

Libraries  are  loaded  automatically  in  the  course  of  executing  certain  functions.  You  will  not  normally 
notice  this.  For  example,  the  TAGS  library  is  automatically  loaded  in  whenever  you  use  M-.  or  Visit  fag 
Table  for  the  first  time.  Ibis  process  is  known  as  "autoloading".  It  is  used  to  make  the  functions  in  the 
LAGS  library  available  without  the  user's  having  to  know  to  load  die  library  himself,  while  not  taking  up 
space  in  KMACScs  of  people  who  aren’t  using  them.  Ibis  works  by  simply  calling  Load  1. ibrary  on  the 
library  known  to  lie  needed.  Anodier  kind  of  "autoloading"  loads  a  library  temporarily,  the  way  Run  Library 
does.  'Ibis  is  done  when  you  vise  the  DIRKD  function,  for  example,  since  the  DIRKD  library  is  not  needed 
after  die  DIRKD  function  returns.  This  works,  not  by  calling  Run  Library,  but  by  doing  M.A.  which  is  how 
Run  Library  also  works. 

You  can  make  your  own  libraries,  which  you  and  other  people  can  then  use,  if  you  know  how  to  write 
Tl -VO  code.  See  the  file  INIO;CONV  >,  node  Lib,  for  more  details. 
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22.3.  Variables 

A  variable  is  a  name  which  is  associated  with  a  value,  either  a  number  or  a  string.  KM  ACS  uses  many 
variables  internally,  and  has  others  whose  purpose  is  to  be  set  by  the  user  for  customization.  (Ilicy  may  also 
be  set  automatically  by  major  modes.)  One  example  of  such  a  variable  is  the  Kill  Column  variable,  which 
specifies  the  position  or  the  right  margin  (in  characters  from  the  left  margin)  to  be  used  by  the  fill  and  justify 
commands. 

Hie  easiest  way  for  the  beginner  to  set  a  named  variable  is  to  use  the  function  Kdit  Options,  litis  shows 
you  a  list  of  selected  variables  which  you  arc  likely  to  want  to  change,  together  with  their  values,  and  lets  you 
edit  them  with  the  normal  editing  commands  in  a  recursive  editing  level.  Don't  make  any  changes  in  die 
names,  though!  ist  change  the  values.  Digits  with  maybe  a  minus  sign  stand  fot  a  numeric  value  of  the 
variable,  while  siting  values  are  enclosed  in  douhlcquolcs.  Ivach  option  is  followed  by  a  comment  which  says 
what  the  option  is  for.  Type  the  I  lelp  character  for  more  information  on  the  format  used. 

When  you  arc  finished,  exit  Kdit  Options  using  C-M-C  and  the  changes  will  take  effect.  If  you  decide  not 
to  make  the  changes,  C-j  gets  out  without  redefining  the  options.  See  section  6.2  (Recursive  Kditing  I  .cvclsj, 
page  26. 

If  you  give  Kdit  Options  a  string  argument,  it  shows  you  only  the  options  whose  names  include  the  string, 
l-or  example,  M-X  Kdit  Optionsttfll<cr>  shows  only  the  options  that  have  "Kill"  in  dteir  names,  'litis  is 
much  more  convenient,  if  you  know  vvliat  you  plan  to  do. 

I  lowevcr.  Kdit  Options  can  be  used  only  to  set  a  variable  which  already  exists,  and  is  marked  as  an  option. 
Some  commands  may  refer  to  variables  which  do  not  exist  in  the  initial  environment.  Such  commands  always 
use  a  default  value  if  the  variable  does  not  exist,  in  these  eases  you  must  create  die  variable  yourself  if  you 
wish  to  use  it  to  alter  the  behavior  of  the  command.  You  can  use  M-X  Set  Variable  for  this.  You  can  set  the 
variable  !o  a  numeric  value  by  doing  C-U  <numbcr>  M-X  Set  VariableKvarnanicXcr>,  or  to  a  string  by 
doing  M-X  Set  VariabIcKvamamc>Kslring><cr>. 

In  fact,  you  can  use  Set  Variable  to  set  any  variable,  whether  it  exists  already  or  not.  For  existing  variables, 
it  does  not  matter  whether  you  use  upper  ease  or  lower  ease  letters,  and  you  arc  allowed  to  abbreviate  die 
name  as  long  as  the  abbreviation  is  unique.  If  the  variable  might  not  exist  yet,  you  can’t  abbreviate  it  (how 
could  KM  ACS  know  what  it  was  an  abbreviation  of?),  and  while  either  upper  ease  or  lower  case  will  still 
work,  you  are  encouraged  to  capituli/e  each  word  of  the  name  for  aesthetic  reasons  since  KMACS  stores  the 
name  as  you  give  it. 


I’o  examine  the  vaiuc  of  a  single  variable,  the  command  M-X  View  VuriubleKvarnamcXcr>  can  be  used. 
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If  you  want  to  set  a  variable  a  paiticular  way  .each  lime  you  use  KM  ACS,  you  can  use  an  Init  file  or  an 
KVARS  file.  This  is  one  of  the  main  ways  of  customizing  KMACS  for  yourself.  An  init  file  is  a  file  of  TliCO 
code  to  be  executed  when  you  start  KMACS  up.  ITicy  arc  very  general,  but  writing  one  is  a  black  art.  You 
might  be  able  to  get  an  expert  to  do  it  for  you,  or  modify  a  copy  of  someone  clsc's.  Sec  tire  file  INFO; 
CONV  >.  node  Init,  for  details.  An  KVARS  file  is  a  much  simpler  tiling  which  you  can  do  yourself.  See 
section  22.7  [KVARS  files],  page  120. 

Values  of  variables  can  be  specified  by  the  file  being  edited.  For  example,  if  a  certain  file  ought  to  have  a 
50  column  width,  it  can  specify  a  value  of  50  for  the  variable  Fill  Column.  'ITien  Fill  Column  will  have  the 
value  50  whenever  this  file  is  edited,  by  anyone.  Kditing  other  files  is  not  afTcctcd.  See  section  22.6  [Locals], 
page  1 18.  for  how  to  do  this. 

You  can  get  a  list  of  ail  variables,  not  just  those  you  are  likely  to  want  to  edit,  by  doing  M-X  I  .ist  Variables. 
Giving  1  ist  Variables  a  suing  argument  show*  only  the  variables  whose  names  or  values  contain  that  string 
(like  the  function  Apropos).  M-X  Describe  can  be  given  a  variable’s  name  instead  of  a  function's  name;  it 
prints  the  variable's  value  and  its  documentation,  if  it  has  any. 

You  can  also  set  a  variable  with  the  TKCO  command  <vnl>UKvarnamc>*  or  :lKvarname>Kstring>*. 
Iliis  is  useful  in  init  files. 

Any  variable  can  be  made  local  to  a  specific  buffer  with  the  TKCO  command  M. I /variable  namc». 
‘IThis,  if  you  want  the  comment  column  to  be  column  50  in  one  buffer,  whereas  you  usually  like  40.  then  in 
the  one  buffer  do  M.LCommcnt  Column*  using  the  minibufi'er.  'Iltcn.  you  can  do  50U*Commcnt  Column* 
in  that  buffer  and  other  buffers  will  not  be  affected,  'litis  is  how  local  inodes  lists  in  files  work. 

Most  local  variables  are  killed  (m.idc  no  longer  local)  if  you  change  major  modes.  They  arc  therefore 
called  "mode  locals".  'Iliere  arc  also  "permanent”  locals  which  arc  not  killed  by  changing  modes;  use  2.M.I. 
to  create  one.  Permanent  locals  arc  used  by  things  like  Auto  Save  mode  to  keep  internal  information  about 
the  buffer,  as  opposed  buffer-specific  customizations.  See  the  file  !NFO;CONV  >,  node  Variables,  for 
information  on  how  local  variables  work,  and  additional  related  features. 


22.4.  The  Syntax  Table 

Ail  the  KMACS  commands  which  parse  words  or  balance  parentheses  arc  controlled  by  the  syntax  table. 
Kach  ASCI!  character  has  a  word  syntax  and  a  Lisp  syntax.  By  changing  the  word  syntax,  you  can  control 
whether  a  character  is  considered  a  word  delimiter  or  part  of  a  word.  By  changing  the  Lisp  syntax,  you  can 
control  which  characters  are  parentheses,  which  ones  arc  parts  of  symbols,  which  ones  arc  prefix  operators, 
and  which  ones  arc  just  ignored  when  parsing  s-expressions. 
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'Hie  syntax  table  is  actually  a  string  which  is  128*5  characters  long.  Kach  group  of  5  consecutive  characters 
of  the  syntax  table  describe  one  ASCII  characters  syntax:  but  oniy  the  first  three  of  each  group  arc  used.  To 
edit  the  syntax  table,  use  M-X  1-xJit  Syntax  Table.  Hut  before  we  describe  this  command,  let's  talk  about  the 
syntax  of  the  syntax  table  itself. 

'Hie  first  character  in  each  group  of  five  sets  the  word  syntax.  This  can  be  either  "A”  or  a  space.  "A" 
signifies  an  alphabetic  character,  whereas  a  space  signifies  a  separator  character. 

Ihe  second  character  in  each  group  is  the  l.isp  syntax.  It  has  many  possible  values: 

A  an  alphabetic  character 

space  a  whitespace  or  nonsignificant  character 
(  an  open  parenthesis 

)  a  close  parenthesis 

:  a  continent  starter 

tM  a  comment  endcr 

|  a  string  quote 

/  a  character  quote 

a  prefix  character 

Tims,  several  characters  can  each  he  given  the  syntax  of  parentheses.  The  automatic  display  of  matching 
feature  uses  the  syntax  table  to  decide  u  hen  u>  go  into  operation  as  well  as  how  to  balance  the  parentheses. 

Hie  syntax  of  "prefix  character"  means  that  the  character  becomes  part  of  whatever  object  follows  it.  or 
can  also  be  in  the  middle  of  a  symbol,  hut  docs  not  constitute  anything  by  itself  if  surrounded  by  whitespace. 

A  character  quote  character  causes  itself  and  the  next  character  to  be  treated  as  alphabetic. 

A  siring  quote  s  one  which  matches  in  pairs.  All  characters  inside  a  pair  of  string  quotes  arc  treated  as 
alphabetic  except  fur  the  character  quote,  which  retains  its  significance,  and  can  be  used  to  force  a  string 
quote  or  character  quote  into  a  string. 

A  comment  starter  is  taken  to  start  a  comment,  which  ends  at  the  next  comment  endcr.  suppressing  the 
norm.:!  syntax  Gf  all  characters  between.  Nut  all  the  commands  which  might  be  expected  to  know  about 
comments  do  know  about  them:  there  a  problems  more  than  simply  a  need  for  work.  Also,  the  syntax  table 
entry  is  not  wh.it  controls  the  commands  which  deal  specifically  with  comments.  Ilicy  use  the  variables 
Comment  Start.  Comment  begin.  Comment  laid,  etc.  Only  the  indentation  commands  use  the  syntax  table 
for  this. 

flic  third  character  in  each  group  controls  automatic  parenthesis  matching  display.  It  is  defined  only  for 
characters  which  have  the  l.isp  syntax  of  close  parentheses,  and  for  them  it  should  contain  the  appropriate 
matching  open  parenthesis  character  (or  a  space).  If  a  dose  parenthesis  character  is  matched  by  the  wrong 
kind  of  open  parenthesis  character,  the  bell  will  ring.  If  the  ihiid  syntax  table  character  of  a  close  parenthesis 
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is  a  space,  any  open  parenthesis  is  allowed  to  match  it. 

The  fourth  and  fifth  characters  in  eacii  group  should  always  be  spaces,  for  now.  'ITiey  arc  not  used,  'llic 
reason  they  exist  is  so  that  word-wise  indexing  can  be  used  on  the  PDP-10  ti:  access  the  syntax  of  a  character 
given  in  an  accumulator. 

Hdit  Syntax  Table  displays  the  syntax  table  broken  up  into  labelled  five-character  groups.  You  can  see 
easily  what  the  syntax  of  any  character  is.  You  arc  not  editing  the  table  immediately,  however.  Instead,  you 
arc  asked  for  the  character  whose  syntax  you  wish  to  edit.  After  typing  it,  you  arc  positioned  at  that 
character's  live-character  group.  Overwrite  mode  is  on,  so  you  can  simply  type  the  desired  syntax  entries. 
You  can  also  do  arbitrary  editing,  but  be  careful  not  to  change  the  position  in  the  buffer  of  anything.  When 
you  exit  the  recursive  editing  level,  you  arc  asked  for  another  character  to  position  to.  An  Allmode  at  this 
point  exits  and  makes  the  changes.  A  C-J  at  any  time  aborts  the  operation. 

Many  major  modes  alter  the  syntax  table,  batch  major  mode  creates  its  ow  n  syntax  table  once  and  rcselccts 
the  same  string  whenever  the  mode  is  selected,  in  any  buffer.  Thus,  all  buffers  in  Text  mode  at  any  time  use 
the  same  syntax  table.  This  is  important  because  if  you  ever  change  the  syntax  table  of  one  buffer  that  is  in 
Text  mode,  you  change  them  all.  It  is  possible  to  give  one  buffer  a  local  copy  with  a  TFCO  program: 

MM  Make  Local  Q-Registor*. .D*W  :G..DU..D 
The  syntax  tables  belonging  to  the  major  modes  are  not  prei.iiliali/.cd  in  KM  ACS;  they  arc  created  when  the 
major  mode  is  invoked  for  die  first  time,  by  copying  the  default  one  and  making  specific  changes.  Tims,  any 
other  changes  you  have  made  in  the  default  (bundninental  mode)  syntax  table  at  the  beginning  propagate 
into  all  modes’  syntax  tables  unless  those  modes  specifically  override  them. 

TFCO  programs  and  inil  files  can  most  easily  change  the  syntax  table  with  the  function  &  Alter  ..I)  (look 
at  its  documentation).  The  syntax  table  is  kept  in  the  q-register  named  ..I),  which  explains  that  name. 


22.5.  FS  Flags 

FS  flags  arc  variables  defined  and  implemented  by  TFCO  below  the  level  of  I -MACS.  Some  of  them  arc 
options  which  control  the  behavior  of  parts  of  TFCO  such  as  the  display  processor.  Some  of  them  control  the 
execution  of  TFCO  programs;  you  are  not  likely  to  want  to  change  these.  Others  simply  report  information 
from  inside  TFCO.  The  list  of  FS  Hags  is  fixed  when  I'lvCO  is  assembled  and  each  one  exists  for  a  specific 
purpose. 

FS  flags  arc  used  mostly  <y  the  TFCO  programmer,  but  some  of  them  arc  of  interest  to  the  FMACS  user 
doing  minor  customization.  For  example,  S*'S  KCIIO  LINKS*  is  the  number  of  lines  in  the  echo  aica.  By 
sctt.iig  tiiis  flag  you  can  make  the  echo  area  bigger  or  smaller. 
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To  get  the  value  of  an  FS  flag,  use  the  TKCO  command  FS  followed  by  the  name  of  the  flag,  terminated 
by  an  Altmode.  Spaces  in  the  name  of  the  flag  are  completely  ignored,  and  ease  does  not  matter.  Thus,  FS 
Kcho  Fines*  =  executed  in  the  minibuffer  prints  the  number  of  lines  in  the  echo  area,  assuming  it  is  a 
number.  The  easiest  way  to  examine  a  flag’s  value  with  KM  ACS  commands  is 
C-M-X  View  Variable<cr>  (FS  Echo  Lines*)<cr> 

This  works  regardless  of  the  type  of  value  stored  in  the  FS  flag. 

To  set  the  flag,  give  the  FS  command  a  numeric  argument  (which  must  be  a  string  pointer,  if  the  intended 
value  is  a  string).  For  example,  in  the  minibuffer  or  an  init  file,  do 
2FS  Echo  Lines* 

Be  warned  that  FS  always  returns  a  value,  so  put  a  CUFF'  after  it  to  discard  the  value  if  necessary. 

It  is  possible  to  make  an  FS  Hag's  value  local  to  a  buffer.  Sec  the  file  INF'0;C0N  V  >.  node  Vars. 

The  documentation  of  individual  FS  Hags  can  be  found  through  Help  T.  Help  I'  FS  Kcho  Fincs<cr>  prints 
the  desci  ipiion  of  FS  F.CI  10  I  .INFS*.  Spaces  arc  not  significant  in  I  lelp  T  either.  A  list  of  just  the  names  of 
all  FS  Hags  is  printed  by  the  function  I  .ist  TKCO  FS  Flags,  found  in  the  library  PURIFY. 

22.6.  Local  Variables  in  Files 

By  putting  a  "local  modes  list"  in  a  file  you  can  cause  certain  major  or  minor  modes  to  be  set,  or  ceitain 
character  commands  to  be  defined,  whenever  you  arc  visiting  it.  For  example,  KM  ACS  can  select  l.isp  mode 
for  that  file,  or  it  can  turn  on  Auto  Fill  mode,  set  up  a  special  Comment  Column,  or  put  a  special  command 
on  the  character  C-M-Comma.  Focal  modes  can  specify  the  major  mode,  and  the  values  of  any  set  of  named 
variables  and  command  characters.  FomI  modes  apply  only  while  the  buffer  containing  the  file  is  selected; 
they  do  not  extend  to  other  files  loaded  into  other  buffers. 

the  simplest  kind  of  iocal  mode  specification  sets  only  the  major  mode.  You  put  the  mode’s  name  in 
between  a  pair  of  ”-*-"’s,  anywhere  on  the  first  nonblank  line  of  the  file.  For  example,  the  first  line  of  this  file 
contains  Text-*-,  implying  that  this  file  should  be  edited  in  Text  mode. 

1  o  specify  more  that  just  the  major  mode,  you  must  use  a  "local  modes"  list,  which  goes  in  the  hist  page  of 
the  file  (it  is  best  to  put  it  on  a  scpaiate  page).  The  local  modes  list  starts  with  a  line  containing  the  string 
"Focal  Modes:",  and  ends  with  a  line  containing  the  string  "lend:". 

I  inch  line  of  the  local  modes  list  should  have  the  form  <varnamc>:<valuc>  (not  counting  the  prefix  and 
suffix,  if  any),  which  is  a  request  to  set  one  variable.  <varnamc>  stands  for  the  name  of  the  variable  and 
<valuc>  stands  for  the  desired  value.  The  name  must  not  be  abbreviated.  If  <vnlue>  is  a  numeral  (which 
means  no  spaces!),  the  value  is  a  number;  otherwise,  it  is  <value>  as  a  string.  To  set  a  command  character, 


Simple  Customization 


119 


make  <varnamc>  the  name  of  the  character  as  a  q-register,  such  as  "...tR,"  for  C-M -Comma,  and  make 
<valuc>  be  a  string  of  THCO  commands  which  will  return  the  desired  value  (this  is  so  you  can  write 
M.MFoo*  to  define  the  character  to  run  the  function  Foo). 

'Hie  major  mode  can  be  set  by  specifying  a  value  for  the  variable  "Mode"  (don’t  try  setting  the  major  mode 
this  way  except  in  a  local  modes  list!).  It  should  be  the  first  thing  in  the  local  modes  list,  if  it  appears  at  all.  A 
function  M-X  Foo  can  be  defineJ  locally  by  putting  in  a  local  setting  for  the  variable  named  "MM  Foo".  See 
section  5.2  [FunclionsJ,  page  21. 

'Flic  line  which  starts  the  local  modes  list  does  not  have  to  say  only  "Focal  Modes:”.  If  there  is  other  text 
before  "Focal  Modes:",  that  text  is  called  the  "prefix",  and  if  there  is  other  text  after,  that  is  called  the 
"suffix".  If  these  arc  present,  each  entry  in  the  local  modes  list  should  have  the  prefix  before  it  and  the  suffix 
after  it.  This  includes  the  "Hnd:"  line.  The  prefix  and  suffix  aie  included  to  disguise  the  local  modes  list  as  a 
comment  so  that  the  compiler  or  text  formatter  will  not  be  perplexed  by  it.  If  you  do  not  need  to  disguise  the 
local  modes  list  as  a  comment  in  this  way,  do  not  bother  with  a  prefix  or  a  suffix. 

Aside  from  the  "Focal  Modes:"  and  the  "Hnd:",  and  the  prefix  and  suffix  if  any.  a  local  modes  list  looks 
like  an  HVARS  file.  However,  comments  lines  arc  not  allowed,  and  you  cannot  redefine  C-X  subcommands 
due  to  fundamental  limitations  of  the  data  structure  used  to  remember  local  variables.  Sorry.  See 
section  22.7  [HVARS  files],  page  120.  for  more  information. 

i  lore  is  an  example  of  a  local  modes  list: 

; ; ;  Local  Modes :  : :  : 

; ; ;  Mode:Lisp  : : : 

; ; ;  Comment  Column : 0  : : : 

;;;  Comment  Start:;;;  ::: 

;;;  ..tR/:  m.nrR  My  Funny  Meta-Slash*  ::: 

; ; ;  End:  : : : 

Note  that  die  prefix  is "  and  the  suffix  is "  :::".  Note  also  that  the  value  specified  for  the  Comment  Sum 
variable  is  ",  which  is  the  same  as  the  prefix,  so  the  local  modes  list  looks  like  a  lot  of  comments.  We  used 
a  suffix  iu  this  example,  but  they  arc  usually  not  used  except  in  languages  which  requite  comment 
terminators. 

’Hie  last  page  of  the  file  must  be  no  more  than  10000  characters  long  or  the  local  modes  list  will  not  be 
recognized.  This  is  because  FMACS  finds  the  local  modes  list  by  scanning  back  only  10000  characters  from 
the  end  of  the  file  for  the  last  formfeed,  and  then  looking  forward  for  the  "Focal  Modes:"  string.  'Ibis 
accomplishes  these  go<ils:  a  stray  "Focal  Modes:"  not  in  the  last  page  is  not  noticed;  and  visiting  a  long  file 
that  is  all  one  page  and  has  no  local  mode  list  need  not  take  the  time  to  search  the  whole  file. 
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22.7.  Init  Files  and  EVARS  Files 

KMACS  is  designed  to  be  customizable;  each  user  can  rearrange  tilings  to  suit  his  taste.  Simple 
customizations  arc  primarily  of  two  types:  moving  functions  from  one  character  to  another,  and  setting 
variables  which  functions  refer  to  so  as  to  direct  their  actions.  Beyond  this,  extensions  can  involve  redefining 
existing  functions,  or  writing  entirely  new  functions  and  creating  shamble  libraries  of  them. 

The  most  general  way  to  customize  is  to  write  an  init  file,  a  TKCO  program  which  is  executed  whenever 
you  start  KMACS.  The  init  file  is  found  by  looking  for  a  paiTcular  filename,  <homc  dircctory>;<uscr 
n,ime>KMACS.  This  method  is  general  because  the  program  can  do  anything.  It  can  ask  you  questions  and 
do  things,  rather  than  just  setting  up  commands  for  later.  However.  TKCO  aide  is  arcane,  and  only  a  few 
people  learn  how  to  write  it.  If  you  need  an  init  file  and  don’t  feel  up  to  learning  to  write  TKCO  code,  ask  a 
local  expert  to  do  it  for  you.  Sec  the  file  INKO;CONV  >,  for  more  about  init  files. 

Ilowcvei,  simple  customizations  can  be  done  in  a  simple  way  with  an  KVARS  file.  Such  a  file  serves  the 
same  sort  of  purpose  as  an  init  file,  but  instead  of  TKCO  code,  it  contains  just  a  list  of  variables  and  values. 
Kach  line  of  the  KVARS  file  names  one  variable  or  one  command  character  and  says  how  to  redefine  it. 
Kmpty  lines,  and  lines  stalling  with  spaces,  are  ignored.  They  can  be  used  as  comments.  Your  KVARS  file  is 
found  by  its  filename,  .is  an  init  file  is,  but  it  should  be  called  <homc  directory>;<uscr  name>  KVARS  instead 
of  KMACS.  You  can  have  both  an  init  Hie  and  an  KVARS  file  if  you  want,  as  long  as  your  init  file  calls  the 
default  init  file,  since  that  is  what  pioccsses  the  KVARS  file. 

To  set  a  vaiiablc,  include  in  the  KVARS  file  a  line  containing  the  name  of  the  variable,  a  colon,  and  the 
value.  If  you  want  a  string  as  a  value,  give  the  string;  if  you  want  a  number  as  a  value,  give  the  digits  with  an 
optional  minus  sign.  (If  you  happen  to  want  a  value  which  is  a  string  of  all  digits,  you  arc  out  of  luck.)  Du  not 
put  spaces  around  the  colon  for  visual  effect.  Space  before  the  colon  is  part  of  the  variable  name,  and  space 
after  the  colon  is  part  of  die  value  of  the  variable.  Kxamplcs: 

Comment  Column: 70 

Comment  Start:; 

Text  Mode  Hook: lM.LAuto  Fill  Mode* 

T  ext  Mode  I  look,  by  the  way,  is  supposed  to  hold  a  TKCO  program  to  be  executed  whenever  Text  mode  is 
cnlcied,  and  the  TKCO  program  supplied  by  (his  particular  definition  is  designed  to  turn  on  Auto  Kill  mode 
at  that  time.  T  he  effect  is  that  Auto  Kill  is  always  on  when  you  are  in  T  ext  inode. 

lo  redefine  a  command  character  is  a  little  more  complicated.  Instead  of  the  name  of  a  variable,  give  a  tR 
(conliol-R)  followed  by  the  character.  Since  the  general  Control  and  Meta  character  cannot  be  part  of  a  file, 
all  Control  and  Meta  characters  are  represented  in  a  funny  way:  after  the  tR  put  the  residue  of  the  character 
after  removing  the  Control  and  Meta,  and  before  the  tR  put  periods,  one  for  Control,  two  for  Meta,  and  three 
for  '.ontrol-Mcta.  Tints,  C-l)  is  represented  by  ",tRD"  and  C-M-;  is  represented  by  "...tR;".  Lower  ease 
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characters  such  as  C-a  arc  usually  defined  as  "execute  the  definition  of  the  upper  case  equivalent". 
Therefore,  by  redefining  the  C-A  command  you  also  change  C-a;  but  if  you  redefine  C-a,  by  saying  ".tRa" 
instead  of  ".tRA",  you  will  not  change  C-A.  So  be  careful  about  ease. 

Instead  of  die  value  of  a  variable,  for  command  character  redefinition  you  must  give  a  TF.CO  expression 
that  returns  the  desired  definition,  'Ibis  is  to  make  it  easy  to  use  any  function  whose  name  you  know,  because 
M.M  FOO*  is  an  expression  that  returns  the  definition  of  the  function  FOO.  Hxample: 

. tRK :  M.M~R  Kill  Line* 

would  give  C-K  the  definition  that  it  normally  ha:..  Remember  that  in  names  of  functions  the  "AR"  is  actually 

a . and  an  R,  not  a  Con'.rol-R.  The  space  before  die  M.M  docs  not  hurt  in  this  case  because  it  is  ignored  by 

TFCO  expression  execution. 

Some  non-printing  characters  arc  a  little  tricky  to  redefine.  For  example,  you  must  know  that  Return, 
I  inefeed,  Tab.  Backspace  and  Altinodc  are  not  die  same  in  TFCO’s  command  character  set  as  C-M,  C-J,  C-l, 
C-ll  and  C-[,  even  though  ir  ASCII  they  are  synonymous.  By  saying  .tRJ  you  will  redefine  C-J;  by  saying 
tR  followed  by  a  Linefeed  (which  you  must  insert  in  the  LVARS  file  by  typing  C-Q  Linefeed)  you  can 
redefine  Linefeed.  Not  malty,  C-J  is  defined  as  "execute  the  definition  of  Linefeed",  so  you  arc  better  off 
redefining  Linefeed. 

You  can  also  redefine  a  subcommand  of  a  prefix  character  such  as  C-X.  For  this,  you  have  to  know  where 
the  character's  dispatch  table  is  stored.  For  C-X,  the  location  of  the  dispatch  is  called  ”.X";  you  won’t  have 
any  other  prefix  character  unless  you  define  them  yourself.  See  the  file  1NF0;C0NV  >,  node  Prefix. 
Knowing  the  location,  you  specify  the  subcommand  by  writing  :locntion(t''chnracter).  Ibis  looks  silly,  but  it 
is  a  TFCO  expression  with  the  right  meaning.  For  example,  redefining  C-X  C-S,  the  location  is  ”.X”  and  die 
character  is  tS,  so  we  say 

:.X(t“tS):  H.H-'R  Save  File* 

This  gives  C-X  C-S  the  definition  that  it  normally  lias.  Tlic  subcommand  character  (tS  in  diis  ease)  can 
represent  itself  in  the  KVARS  file  with  no  need  for  dots,  because  subcommand  characters  arc  just  ASCII,  with 
no  Meta  allowed. 

To  connect  a  command  character  to  a  function  from  a  library  which  is  not  normally  loaded,  you  can  do 
.tR,:  MM  l.oad*F00*W  M.MBar* 

This  loads  the  library  FOO  and  connects  the  command  C-Comma  to  the  function  Bar,  presumably  found  in 
that  library.  The  "W"  discards  the  value  leturned  by  MM  Load*  so  that  it  does  not  interfere  with  the 
M.M  Bar*. 

To  simply  load  a  library  you  can  wiitc  a  definition  lor  Such  a  definition  is  ignored  except  that  the 
value  you  specify  is  executed  as  a  TFCO  expression.  Tims,  an  arbitrary  TFCO  expression  can  be  snuck  into 
an  FVARS  file.  To  load  the  library  FOO,  use  the  expression  MM  Load*  FOO*. 
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*:  MM  Load*F00* 

Please  refrain  from  giving  newcomers  to  KM  ACS  a  copy  of  your  own  init  file  before  they  understand  what 
it  docs.  Kveryone  prefers  his  own  customizations,  and  there  is  always  a  tendency  to  proselytize,  but  by  the 
same  token  your  protege’s  tastes  may  be  different  from  yours.  If  you  offer  him  your  customizations  at  the 
time  when  he  is  ready  to  understand  what  difference  they  make  and  decide  for  himself  what  l.c  prefers,  then 
you  will  help  him  get  what  lie  wants,  fell  him  about  each  individual  change  you  made,  and  let  him  judge 
them  one  by  one.  There  is  no  reason  for  him  to  choose  all  or  nothing. 


22.7.1.  EVARS  File  Examples 

I  lerc  arc  some  examples  of  how  to  do  various  useful  things  in  tin  KVARS  file. 

This  causes  new  buffers  to  be  created  in  l.isp  mode: 

Default  Major  Mode:LISP 

* 

This  causes  new  buffers  to  have  auto  fill  mode  turned  on: 

Buffer  Creation  Hook:  1M.I.  Auto  Fill  Mode* 

j  his  causes  all  Text  mode  buffers  to  have  auto  fill  mode  turned  on: 

Text  Mode  Hook:  1M.L  Auto  Fill  Mode* 

I  bis  causes  C-M-G  to  be  undefined  by  copying  the  definition  of  OM -Space  {which  is  undefined): 
...tRG:  Q...TR  (a  space  follows  the  control- R) 

1  his  redefines  C-S  to  be  a  single  character  search  command,  and  M-S  to  be  a  non-incremenlal  string 
search: 

. tRS :  M.M  AR  Character  Search* 

..tRS:  M.M  ~R  String  Search* 

T  his  redefines  C-X  V  to  run  View  File: 

:.X(f*V):  M.M  View  File* 

This  makes  M-M  a  prefix  charactci  and  defines  M-M  W  to  mark  a  word  ana  M-W  Pto  maik  a  paragraph. 
It  stores  the  dispatch  vector  for  the  prefix  character  in  q-regislcr  .Y. 


I  i 
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•€> 

<*  9> 


. .  tRM :  MM  Make  Prefix  Character*. Y* 

:.Y(t/,W):  M.M  ~R  Mark  Word* 

:.Y(t~P):  M.M  "R  Mark  Paragraph* 

This  loads  the  library  LUNAR  and  defines  C-Q  to  run  a  useful  function  in  dial  library: 

*:  MM  Load  Library*LUNAR* 

. tRQ:  M.M  *R  Various  Quantities* 

This  causes  Auto  Save  mode  to  save  under  the  visited  filenames: 

Auto  Save  Visited  File: 1 

1'his  causes  TAGS  to  bring  new  files  into  separate  buffers: 

TAGS  Find  Fi 1 e : 1 

This  stops  the  message  'TM  ACS  version  nnn.  Type ...  for  I  lelp"  from  being  printed. 

Inhibit  Help  Messaged 

'1'his  redefines  the  list  syntax  of  "%’’  to  be  for  ’’comment  starter",  and  that  of  to  be  "A”  for 
’’alphabetic’’: 

*:  ltmn&  Alter  .  .D*%;;A* 


22.7.2.  Inii  File  Examples 


I  lore  arc  the  ways  to  do  exactly  the  same  filings  in  an  init  file. 

'1'his  causes  new  buffers  to  be  created  in  Lisp  mode: 

:I*Default  Major  Mode*LISP* 

1'his  causes  new  buffers  to  have  auto  fiil  mode  turned  on: 

:I*  1M.L  Auto  Fill  Model]*  ♦  M.VBnffer  Creation  Hook* 

It  is  different  because  file  variable  docs  not  already  exist  Note  die  t]  used  for  getting  the  Altmodc  into  the 
value. 

This  causes  all  Text  mode  buffers  to  have  auto  Till  mode  turned  on: 

:  I*  1M.L  Auto  Fill  Modet]*  ♦  M.VText  Mode  Hook* 

This  causes  C-M-G  to  be  undefined  by  copying  the  definition  of  C-M-Space  {which  is  undefined): 
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Q...tR  U...TRG 

This  redefines  C-S  to  be  a  single  character  search  command,  and  M-S  to  be  a  non-incremcntal  string 
search: 

M.M  "R  Character  Search*  U.tRS 
M.M  ~R  String  Search*  U..TRS 

‘111 is  redefines  C-X  V  to  run  View  File: 

M.M  View  File*  U: .X(t~V) 

This  makes  M-M  a  prefix  character  and  defines  M-M  W  to  mark  a  word  and  M-W  P  to  mark  a  paragraph. 

It  stores  the  dispatch  vector  for  the  prefix  character  in  q-registcr  .Y. 

MM  Make  Prefix  Character*. Y*U. .tRM 
M.M  ~R  Mark  Word*  U:.Y(t~W) 

M.M  ''R  Mark  Paragraph*  U:.Y(t*P) 

I  his  loads  the  library  I.UNAR  and  defines  C-Q  to  run  a  useful  function  in  that  library: 

MM  Load  Library*LUNAR* 

M.M  ~R  Various  Quantities*  U.tRQ 

This  causes  Auto  Save  mode  to  save  under  the  visited  filenames: 
lU*Auto  Save  Visited  File* 

Compare  this  and  die  next  example  with  the  first  two,  in  which  string  values  arc  used. 

This  causes  TAGS  to  bring  new  files  into  separate  buffers: 

1M.VTAGS  Find  File* 

This  stops  the  message  "HMACS  version  m»n.  Type ...  for  I  lelp"  from  being  printed. 
lM.VInhibit  Help  Message* 

This  redefines  die  list  syntax  of  to  be  for  "comment  starter",  and  that  of  to  be  "A"  for 
"alphabetic": 

lmm&  Alter  ..0*%;;A* 

22.8.  Keyboard  Macros 

C-X  (  Start  defining  a  keyboard  macro. 

C-.X  )  Hnd  the  definition  of  a  keyboard  macro. 

C-X  K  l-’xccute  the  most  recent  keyboard  macro. 

C-X  Q  Ask  for  confirmation  when  the  keyboard  macro  is  executed. 

C-U  C-X  Q  Allow  the  user  to  edit  for  a  while,  each  time  the  keyboard  macro  is  executed. 

M-X  Name  Kbd  Macro 
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Make  (he  most  recent  keyboard  macro  into  the  permanent  definition  of  a  command. 

A  keyboard  macro  is  a  command  defined  by  the  user  to  abbreviate  a  sequence  of  other  commands.  If  you 
discover  that  you  arc  about  to  type  C-N  C-D  forty  times,  you  can  define  a  keyboard  macro  to  do  C-N  C-l) 
and  call  it  with  a  repeat  count  of  forty. 

Keyboard  macros  differ  from  ordinary  KMACS  commands,  in  that  they  arc  written  in  die  KMACS 
command  language  ratlv.  than  in  TKCO.  'Hi is  makes  it  easier  for  the  novice  to  write  them,  and  makes  them 
more  convenient  as  temporary  hacks.  However,  the  KMACS  command  language  is  not  powerful  enough  as  a 
programming  language  to  be  useful  for  writing  anything  intelligent  or  general.  Kor  such  things.  TKCO  must 
be  used. 

KMACS  functions  were  formerly  known  as  macros  (whi^h  is  part  of  the  explanation  of  the  name  KMACS), 
because  they  were  macros  within  the  context  of  TI-CO  as  an  editor.  We  decided  to  change  the  terminology 
because,  when  thinking  of  KMACS,  we  consider  TKCO  a  programming  language  rather  than  tin  editor.  ‘flic 
only  "macros"  it:  KMACS  now  tire  keyboard  macros. 

You  define  a  keyboard  macro  while  executing  the  commands  which  are  the  definition.  Put  differently,  as 
you  tire  defining  a  keyboard  macro,  the  definition  is  being  executed  for  the  first  time.  This  way,  you  can  see 
what  the  effects  of  your  commands  tire,  so  that  you  don’t  have  to  figure  them  out  in  your  head.  When  you  tire 
finished,  the  keyboard  macro  is  defined  and  also  has  been,  in  effect,  executed  once.  You  can  then  do  the 
whole  tiling  over  again  by  invoking  the  macro. 

22.8.1.  Basic  Use 

To  start  defining  a  keyboard  macro,  type  the  C-X  (  command  (~R  Start  Kbd  Macro).  Kroni  then  on. 
your  commands  continue  ':>  be  executed,  but  also  become  part  of  the  definition  of  the  macro.  "Def  appears 
in  the  mode  line  to  remind  you  of  what  is  going  on.  When  you  arc  finished,  the  C-X  )  command  (*R  Knd 
Kbd  Macro)  terminates  the  definition  (without  becoming  part  of  ill).  'Hie  macro  thus  defined  can  be  invoked 
again  with  the  C-X  K  command  (~R  Kxccutc  Kbd  Macro),  which  may  be  given  a  repeat  count  as  a  numeric 
argument  to  execute  the  macro  many  times.  C-X  )  can  also  be  given-a  repeal  count  as  an  argument,  in  which 
ease  it  repeats  the  macro  that  ma  ty  times,  but  defining  the  macro  counts  its  the  first  repetition  (since  it  is 
executed  as  you  define  it).  So,  giving  C-X  )  an  argument  of  2  executes  the  macro  one  additional  time.  An 
argument  of  /cm  to  C-X  Kor  C-X  )  means  repeat  the  macro  indefinitely  (until  it  gets  an  error). 

If  you  wish  to  stive  a  keyboard  macro  for  longer  than  until  you  define  the  next  one,  you  must  give  it  a 
name.  Do  M-X  Name  Kbd  Mncro4KO(Xcr>  and  the  last  keyboard  macro  defined  ( ll  :  one  which  C-X  K 
would  invoke)  is  turned  into  a  function  and  given  the  name  KOO.  M-X  KOO  will  front  then  on  invoke  that 
particular  macro.  Name  Kbd  Macro  also  reads  a  character  from  the  keyboard  and  redefine  that  character 
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command  to  invoke, the  macro.  If  you  don’t  want  to  redefine  a  command,  type  a  Return  or  kubout.  Only 
self-inserting  and  undefined  characters,  and  those  that  are  already  keyboard  macros,  can  be  redefined  in  this 
way.  Prefix  characters  may  be  used  in  specifying  the  command  to  be  redefined. 

To  examine  the  definition  of  a  keyboard  macro,  use  the  function  View  Kbd  Macro.  Either  supply  the 
name  of  the  function  which  runs  the  macro,  as  a  string  argument,  or  type  the  command  which  invokes  the 
macro,  on  the  terminal  when  View  Kbd  Macro  asks  for  it. 

22.8.2.  Executing  Macros  with  Variations 

If  you  want  to  be  allowed  to  do  arbitrary  editing  at  a  certain  point  each  time  around  the  macro  (different 
each  time,  and  not  remembered  .is  part  of  the  macro),  you  can  use  the  C-U  C-X  Q  command  (~R  Kbd  Macro 
Query).  When  you  arc  defining  the  macro,  this  lets  you  do  sonic  editing,  which  does  not  become  part  of  the 
macro.  When  you  arc  done,  exit  with  C-M-C  to  return  to  defining  the  macro.  When  you  execute  the  macro, 
at  that  same  point,  you  will  again  be  allowed  to  do  some  editing.  When  you  exit  this  time  with  C-M-C.  the 
execution  of  the  macro  will  resume.  If  you  abort  die  recursive  editing  level  with  C'-|.  you  will  abort  the  macro 
definition  orcxccutioi. 

You  can  get  the  effect  of  Quay  Replace,  where  the  macro  asks  you  each  time  around  whether  to  make  . 
change,  by  using  the  command  C-X  Q  w  ith  no  argument  in  your  keyboard  macro.  When  you  are  defining  the 
macro,  die  C-X  Q  docs  nothing,  but  when  the  macro  is  invoked  the  C-X  Q  reads  a  character  from  ..ic 
terminal  to  decide  whether  to  continue.  Hie  special  answers  tire  Space.  Rubout,  Altmodc,  C-L,  C-R.  A 
Space  means  to  continue.  A  Rubout  means  to  skip  the  remainder  of  this  repetition  of  the  macro,  starting 
again  from  the  beginning  in  the  next  repetition.  An  Altmodc  ends  all  repetitions  of  the  macro,  but  only  the 
innermost  macro  (in  ease  it  was  called  from  another  macro).  C-L  clears  the  screen  and  asks  you  again  for 
character  to  say  what  to  do.  C-R  enters  a  recursive  editing  level:  when  you  exit,  you  arc  asked  again  (if  you 
ty  pe  a  Space,  the  macro  will  continue  from  wherever  you  left  things  when  you  exited  tiic  C-R).  Anything  else 
exits  all  levels  of  keyboard  macros  and  is  reread  as  a  command. 
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23.  The  Minibuffer 

M-Altmodc  Invokes  an  empty  minibuficr.  • 

M-%  Invokes  a  minibuficr  initialized  with  a  Query  Replace. 

C-X  Altmodc  Rc-cxccutc  a  recent  minibuffer  command. 

C-X  ~  Add  more  lines  to  the  minibuffer. 

C-\  Meta-prefix  for  use  in  the  minibuffer. 

C-C  C- Y  Rotate  ring  of  recent  minibuffer  commands. 

'Hie  minibuffer  is  a  facility  by  means  of  which  KMACS  commands  can  read  input  from  the  terminal, 
allowing  you  to  use  KMACS  commands  to  edit  the  input  while  you  arc  typing  it.  TT»c  primary  use  of  the 
minibuffer  is  for  editing  and  executing  simple  TKCO  programs  such  as 

MM  Query  Replace>F00 

♦BAR 

♦ 

(which  could  not  be  done  with  M-X  because  Returns  are  pait  of  the  arguments). 

You  can  always  tell  when  you  arc  in  a  minibuficr,  because  the  mode  line  contains  something  in 
parentheses,  such  as  "(Minibuffer)"  or  "(Query  Replace)".  There  is  also  a  line  of  dashes  across  the  screen  a 
few  lines  from  the  top.  Strictly  speaking,  the  minibuficr  is  actually  the  region  of  screen  above  the  line  of 
dashes,  for  that  is  where  you  edit  the  input  that  the  minibuffer  is  asking  you  for.  I  editing  has  been  limited  to  a 
few  lines  so  that  most  of  the  screen  can  continue  to  show  the  file  you  arc  visiting. 

If  you  want  to  type  in  a  Tl-CO  command,  use  llic  minibuffer  with  the  command  Meia-Altmodc, 
(~R  I  execute  Minibuffer).  An  empty  minibuficr  will  appear,  into  which  you  should  type  the  TKCO 
command  string,  l-xit  with  Altmodc  Altmodc,  and  remember  that  neither  of  die  two  Allmodes  is  inserted 
into  your  TKCO  command  although  the  first  one  may  appear  to  be.  When  the  TKCO  command  is  executed, 
"the  buffer"  will  be  the  text  you  were  editing  before  you  invoked  the  minibuffer. 

Often,  a  minibuffer  starts  out  with  some  text  in  it.  This  means  that  you  arc  supposed  to  add  to  that  text,  or, 
sometimes,  to  delete  some  of  it  so  as  to  choose  among  several  alternatives.  For  example.  Meta-%  (~R  Query 
Replace)  provides  you  with  a  minibuffer  initially  containing  the  siring  "MM  Query  Replaced".  The  cursor 
comes  at  the  end.  You  are  then  supposed  to  add  in  the  arguments  to  the  Query  Replace. 

In  a  minibuffer.  you  can  edit  your  input  until  you  arc  satisfied  with  it.  Then  you  tell  KMACS  you  arc 
finished  by  typing  two  Altmodcs.  An  Altmodc  not  followed  by  another  Altmodc  is  simply  inserted  in  the 
buffer.  This  is  because  it  is  common  to  want  to  pul  Altmodcs  into  the  minibuffer.  which  usually  contains  a 
string  ofTKCO  commands.  For  example,  in  Mcta-%  (“R  Query  Replace)  each  argument  must  he  ended  by 
an  Altmodc.  However,  when  you  type  two  Altmodcs  in  a  row.  neither  one  remains  in  the  buffer.  'Hie  two 
Altmodcs  do  nothing  to  the  text  in  the  minibuficr,  they  just  exit. 
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Since  AHmode  is  self-inserting,  typing  Meta  characters  can  he  a  problem.  You  can  do  it  by  using  C-\ 
instead  of  Altmodc  as  the  Meta-prefix.  If  you  type  a  Contiol-Mcta  character  on  your  keyboard,  the 
corresponding  ASCII  control  character  is  inserted  in  the  minibuffer.  'Ihis  is  because  the  Lisp  commands  arc 
rarely  useful  when  editing  TF.CO  code,  but  insertion  of  control  characters  is  frequent  If  you  really  want  to 
use  a  Control-Meta  HMACS  command,  you  must  use  C-C  to  type  it.  You  cannot  use  C-\  C-A  to  type 
C-M-A.  because  C-\  (unlike  Altmodc)  ignores  the  Control  bit  of  the  following  character,  so  you  must  use  C-C 
C-A.  The  mutilation  for  this  quirk  of  C-\  is  that  C-\  C-B  (to  obtain  M-B)  is  easier  to  type  than  C-\  B. 
especially  if  it  is  typed  several  times  in  a  row. 

You  can  cancel  your  input  in  a  minihuffer  and  start  all  over  again  by  typing  C-G.  'Hint  kills  all  the  text  in 
the  minihuffer.  A  C-G  typed  when  the  minihuffer  is  already  empty  exits  from  the  minibuffer.  Usually,  this 
aborts  whatever  command  was  using  the  minihuffer,  so  it  will  return  without  doing  anything  more.  For 
example,  if  you  type  two  C-G’s  at  Mcta-%’s  minihuffer,  you  will  return  to  top  level  and  no  Query  Replace 
will  he  done.  Typing  a  single  C-G  at  a  preinitialized  minihuffer  to  empty  the  buffer  is  not  very  useful,  since 
you  would  have  to  retype  all  the  initial  text. 

The  last  five  distinct  minihuffer  commands  or  M-X  commands  you  have  issued  arc  remembered  in  a  ring 
buffer  in  q-register  .M.  The  C-X  Altmodc  command  ("R  Rc-cxccutc  MinilnifTcr)  rc-cxccutcs  the  last 
command  in  the  ring.  With  an  argument  <n>.  it  rc-cxccutcs  the  <n>  th  previous  command.  Hie  command  is 
primed  out  (only  die  first  40  characters  or  so)  and  you  arc  asked  to  confirm  with  "Y"  or  "N”. 

You  can  also  get  your  previous  minihuffer  and  M-X  commands  back  into  the  minihuffer  to  be  edited  and 
rc-cxccuied  with  changes.  Giving  M-Altmodc  and  argument,  as  in  C-U  M- Altmodc,  causes  die  minibufler  to 
he  lauded  up  with  die  hist  command  in  the  ring,  as  if  you  had  typed  it  in  again  from  scratch.  You  can  then 
edit  it,  execute  it  by  typing  two  AUmodcs.  or  cancel  it  with  C-G.  To  get  an  earlier  •-ommand  string  instead  of 
die  most  recent  one.  use  die  command  C-C  C-Y  once  you  are  in  the  minibufier.  'this  command  “rotates"  the 
ring  of  saved  commands  much  as  M-Y  rotates  die  ring  of  killed  text.  Hsch  C-C  C-Y  reveals  an  earlier 
command  siring,  until  the  ring  lias  rotated  all  die  way  around  and  the  most  recent  one  reappears.  C-C  C-Y  is 
actually  a  way  of  saying  C-N1-Y.  but  ir.  the  minihuffer  dial’s  the  only  way  to  type  it,  since  Altmode  inserts 
itself  and  Control-Meta  characters  insert  control  characters. 

If  you  exit  from  Mcia-Altnuidc  with  a  C-G.  nothing  is  executed  and  the  previous  minibulTcred  command 
string  is  still  rci  i'mbcred  its  die  last  one. 

While  in  a  minihuffer,  if  you  decide  you  want  the  minibuficr  to  use  more  lines  on  the  screen,  you  can  use 
C-X  ~  (*U  Grow  Window)  to  get  more.  It  gets  one  more  line,  or  as  litany  lines  as  its  argument  says. 
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24.  Correcting  Mistakes  and  EMACS  Problems 

If  you  type  an  HMACS  command  you  did  not  intend,  the  results  arc  often  mysterious.  'Ilns  chapter  tells 
what  you  can  do  to  cancel  your  mistake  or  recover  from  a  mysterious  situation.  HMACS  bugs  and  system 
crashes  arc  also  considered. 

24.1.  Cancelling  a  Command 

C-G  Quit.  Cancel  running  or  partially  typed  command. 

C  l  Abort  recursive  editing  level  and  cancel  the  command  which  invoked  iL 

M-X  lop  Level 

Abort  all  recursive  editing  levels  and  subsystems  which  are  currently  executing. 

There  are  three  ways  of  cancelling  commands  which  arc  not  finished  executing:  "quitting"  with  C-G.  and 
"aborting"  with  C-)  or  M-X  Top  Level.  Quitting  is  cancelling  a  partially  typed  command  or  one  which  is 
already  running.  Aborting  is  cancelling  a  command  which  has  entered  a  recursive  editing  level. 

Quitting  with  C-G  is  used  for  getting  rid  of  a  partially  typed  command,  or  a  numeric  argument  that  yon 
don’t  want  It  also  stops  a  running  command  in  die  middle  in  a  relatively  safe  way,  so  you  can  use  it  if  you 
accidentally  give  a  command  which  takes  a  long  time.  In  particular,  it  is  safe  to  quit  out  of  killing:  either  your 
text  will  all  still  be  there,  or  it  will  all  be  in  the  kill  lif.g  (or  maybe  both).  Quitting  an  incremental  search  docs 
special  things  documented  under  searching:  in  general,  it  may  take  two  successive  C-C's  •:?  get  out  of  a 
search.  C-G  can  interrupt  HMACS  at  any  lime,  so  it  is  not  an  ordinary  command. 

Aborting  with  C-j  (Abort  Recursive  Hdil)  is  used  to  get  out  of  a  recursive  editing  level  and  cancel  the 
command  which  invoked  it.  Quilting  with  C-G  cannot  be  used  for  this,  because  it  is  used  to  cancel  a  partially 
typed  command  within  the  recursive  editing  level.  Both  functions  arc  useful.  For  example,  if  you  arc  editing 
a  message  to  he  sent,  C-G  can  be  .•  ed  to  cancel  lire  commands  you  use  to  edit  die  message,  and  C-J  cancels 
sending  the  message.  C-J  cither  tells  you  how  to  resume  the  aborted  command  or  queries  for  confirmation 
before  aborting. 

When  you  arc  in  a  position  to  use  M-X,  you  can  use  M-X  Top  Level.  This  is  equivalent  to  "enough"  C-J 
commands  to  get  you  out  of  all  the  levels  of  subsystems  and  recursive  edits  that  you  arc  in.  C-j  gels  you  out 
one  level  at  a  time,  but  M-X  Top  Level  goes  out  all  levels  at  once.  Both  C-]  and  M-X  Top  Level  arc  like  all 
other  commands,  and  unlike  C-G,  in  mat  they  arc  effective  only  when  HMACS  is  listening. 
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24.2.  What  to  Do  if  EMACS  Acts  Strangely 

This  section  describes  various  conditions  which  can  cause  KM  ACS  not  to  work,  or  cause  it  to  display 
strange  things,  and  how  you  can  correct  them. 

24.2.1.  Error  Message 

When  KM  ACS  prints  an  error  message,  it  occupies  the  top  line  of  the  screen,  ends  with  a  "T\  and  is 
accompanied  by  the  ringing  of  the  bell.  Space  causes  the  error  message  to  disappear  and  be  replaced  by  the 
first  line  of  text  again.  Any  other  command  is  executed  normally  as  if  there  had  been  no  error  message  (the 
error  message  disappears  during  the  redisplay  after  the  command).  However.  *’?”  enters  the  error  handler, 
which  can  be  used  to  inspect  the  function  call  stack.  Type  Help  inside  the  error  handler  to  get  its 
documentation.  Most  users  will  not  be  interested  in  doing  this. 

24.2.2.  Subsystems  and  Recursive  Editing  Levels 

Subsystems  and  recursive  editing  levels  arc  important  and  useful  aspects  of  KMACS.  but  they  can  seem 
ike  malfunctions  to  the  user  who  docs  not  understand  them. 

If  die  mode  line  starts  with  a  bracket  "("  or  a  parenthesis  ”<”,  or  di»cs  not  start  with  die  word  "KMACS”. 
then  you  h.i\c  entered  a  subsystem  (See  section  6.1  {Subsystems],  page  2S.)  or  a  recursive  editing  level  (Sec 
section  6.2  jUccursi.e  Kditing  Levels],  page  26.). 

In  such  a  situation,  first  try  typing  C*J.  This  will  get  out  of  any  recursive  editing  level  and  most  subsystems. 
Hie  usual  mode  line  and  text  display  will  reappear.  If  C-]  does  not  seem  to  have  worked,  type  the  Help 
character.  Instead  of  printing  “Doc  (Type  ?  P>r  Help)"  in  the  echo  area,  it  will  prim  a  list  of  the  subsystem’s 
commands.  One  of  these  should  be  a  command  to  exit  or  abort 

If  the  above  techniques  fail,  try  restarting  (see  section  24.2.7). 

24.2.3.  Garbage  on  (be  Screen 

If  the  data  on  (he  screen  looks  wrong,  it  could  be  due  to  line  noise  on  input  or  output,  a  hug  in  (he 
terminal,  a  bug  in  KMACS  redisplay,  ora  hug  in  ail  KMACS  command.  To  find  out  whether  there  is  really 
anything  wrong  with  your  text,  the  first  thing  to  do  is  type  C  l .  litis  is  a  command  to  dear  the  screen  and 
redisplay  it.  Often  this  will  display  data  which  is  more  pleasing,  'lliiuk  of  it  as  gelling  an  opinion  from 
another  doctor. 
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24.2.4.  Garbage  Displayed  Persistently 

If  KMACS  persistently  displays  garbage  on  the  screen,  or  if  it  outputs  the  right  things  but  scattered  around 
all  the  wrong  places  on  the  screen,  it  may  be  that  KMACS  has  the  wrong  idea  of  your  terminal  type.  The  first 
thing  to  do  in  this  case  is  to  exit  from  KMACS  and  restart  it.  Kach  time  KMACS  is  restarted  it  asks  the  system 
what  terminal  type  you  arc  using.  Whenever  you  detach  and  move  to  a  terminal  of  a  different  type  you 
should  restart  KMACS  as  a  matter  of  course,  if  you  stopped  KMACS  with  the  exit  command,  or  by 
interrupting  it  when  it  was  awaiting  a  command,  then  this  is  sure  to  be  safe. 

The  system  itself  may  not  know'  what  type  of  terminal  you  have.  You  should  try  telling  the  system  with  the 
:TCTYP  command. 

24.2.5.  URK  Error  (Address  Space  Exhausted) 

If  attempting  to  visit  a  file  or  load  a  library  causes  an  "URK"  error,  it  means  you  have  filled  up  the  address 
space;  there  is  no  room  inside  KMACS  for  any  more  files  or  libraries.  In  this  situation  you  can  run  M-X 
Make  Space.  This  command  compacts  the  data  inside  KMACS  to  free  up  some  space.  It  also  offers  to  discard 
data  that  may  he  occupying  a  lot  of  space,  such  as  the  kill  ring  (See  section  9.1  [Killing!,  page  35.),  the  uiujp 
memory  (See  secii  -n  24.3  [Undo],  page  132.),  and  buffers  created  by  RMAI!.,  TAGS  and  INKO.  Another 
way  of  freeing  space  is  to  kill  buffers  with  M-X  Kill  Some  Buffers  (See  section  14  [Buffers],  page  (>7.)  or 
unload  libraries  with  M-X  Kill  Libraries  (Sec  section  22.2  [Libraries],  page  1 12.). 

24.2.6.  All  Type-in  Echoes  anti  Nothing  Else  Happens 

If  you  find  that  KMACS  is  not  responding  to  your  commands  except  for  echoing  them  all  at  the  bottom  of 
the  screen,  including  the  Return  character,  and  that  Rubout  causes  erased  characters  to  be  retyped  instead  of 
erased,  then  you  have  managed  to  exit  from  KMACS  back  to  TKCO.  Often  this  follows  an  "Krror  in  error 
handler"  message  which  indicates  that  a  condition  arose  in  which  die  error  handler  could  not  function.  You 
can  get  hack  into  KMACS  by  typing  :M. .!.♦♦,  or  by  restarting  (see  below).  If  you  ever  it  wit  to  exit  back  to 
TKCO,  you  can  do  M-X  Top  Level  with  an  argument  greater  than  zero.  Before  using  :M. .!.♦♦,  gel  i  id  of  any 
other  characters  you  have  typed  by  mistake  by  typing  a  C-G. 

24.2.7.  KMACS  Hung  ami  Nol  Responding 

Sometimes  KMACS  gets  hung  and  C-G  does  not  work.  The  more  drastic  procedure  of  restarting  KMACS 
may  work  at  such  times.  C-G  can  fail  to  work  because  it  only  takes  effect  between  the  TKCO  commands 


1 32 


(•MACS  Manual  for  ITS  Users 


which  make  up  an  HMACS  program,  never  in  the  middle  of  one  (only  a  few  TKCO  commands  allow  quitting 
at  any  time),  so  as  to  prevent  TKCO's  internal  data  structures  from  becoming  inconsistent.  if  KM  ACS  is  hung 
inside  a  TRCO  command.  C-G  is  not  noticed,  but  restarting  can  still  be  tried. 

To  restart  HMACS.  type  CAM.  or  C-Z  to  stop  HMACS,  then  $G  to  restart  it.  While  restarting  TKCO  in 
this  way  is  usually  safe  (especially  at  times  when  TKCO  is  doing  I/O),  there  arc  certain  times  at  which  it  will 
cause  the  TKCO  data  structures  to  be  inconsistent,  so  do  not  try  it  unless  other  measures  have  failed. 

Your  ultimate  safeguard  against  a  wedged  HMACS  is  to  save  your  work  frequently. 

24,3.  Undoing  Changes  to  the  Buffer 

If  you  mistakenly  issue  commands  that  make  a  great  change  to  the  buffer,  you  can  often  undo  the  change 
without  having  to  know  precisely  how  it  came  about.  This  is  done  by  using  M-X  Undo.  Type  M-X  Undo<cr> 
and  the  change  is  undone.  It  does  not  matter  if  you  have  moved  the  cursor  since  yon  made  the  change;  it  is 
undone  where  it  was  originally  done. 

The  first  thing  Undo  does  is  tell  you  what  kind  of  change  it  plans  to  unde  (kill,  fill,  undo,  case-convert, 
etc).  Then  it  asks  whether  to  go  ahead.  If  you  say  "Y",  the  change  is  actually  undone. 

No;  all  changes  to  the  puffer  can  be  undone:  deletion  (as  opposed  to  killing)  can't  be,  and  changes  in 
indentation  can’t  be,  nor  can  many  forms  of  insertion  (but  they  aren't  as  impottanl  since  they  don't  destroy 
information).  Also,  a  Replace  String  or  Query  Replace  can’t  be  undone,  which  is  a  shame.  The  reason  is  that 
actually  they  make  many  small  changes,  and  Undo  only  knows  how  to  remember  one  contiguous  change. 
Perhaps  someday  I  will  be  able  to  fix  this. 

As  a  result,  when  you  say  Undo,  it  may  undo  something  other  titan  the  latest  change  if  the  hiest  change 
w'as  not  undoablc.  'Phis  might  seem  to  pile  one  disaster  on  another,  but  it  doesn't,  because  you  can  always 
Undo  the  Undo  if  it  didn't  help.  But  you  can  avoid  even  having  to  do  that,  if  you  look  at  what  type  of  change 
Undo  says  it  will  undo. 

If  you  want  to  undo  a  considerable  amount  of  editing,  not  just  the  Iasi  Jiange,  the  Undo  command  can't 
help  you.  but  M-X  Rcveit  Kile  (See  section  1.1.2  (Revertj,  page  57.)  might  be  able  to.  If  you  have  been  writing 
i  journal  flic  (See  section  24.4  |  lournalsj.  page  131),  you  can  replay  the  journal  alter  deleting  the  part  that 
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24.4.  Journal  Files 

A  journal  file  is  a  record  of  ail  die  commands  you  type  during  an  editing  session.  If  you  lose  editing 
because  of  a  system  crash,  an  KMACS  bug,  or  a  mistake  on  your  part,  and  you  have  made  a  journal  file,  you 
can  replay  die  journal  or  part  of  it  to  recover  what  you  lost.  Journal  files  offer  an  alternative  to  auto  saving, 
using  less  time  and  disk  space  if  there  is  no  crash,  but  requiring  more  time  when  you  recover  from  a  crash. 
See  section  1 3.3  [Auto  Save),  page  57. 

24.4.1.  Writing  Journal  Files 

In  order  to  make  a  journal  file,  you  must  load  the  JOURNAL  library  and  then  execute  M-X  Start  Journal 
KilcKfilcnamcXcrX  Immediately,  most  of  the  current  status  of  KMACS  is  recorded  in  the  journal  file,  and 
all  subsequent  commands  arc  recorded  as  they  are  typed.  This  happens  invisibly  and  silently.  The  journal 
file  is  made  fully  up  to  date  on  the  disk  after  every  50th  character,  so  the  last  50  characters  of  type  in  is  the 
most  you  can  lose. 

The  default  filenames  for  the  journal  file  arc  <hotnc  dircctory>;<uscr  natnc>  JRNL  There  is  rarely  a 
reason  to  use  any  other  name,  beta,.  you  only  need  one  journal  file  unless  you  tire  running  two  KMACSes 
at  the  same  time. 

24.4.2.  Replaying  Journal  Files 

To  replay  the  journal  file,  get  a  fresh  KMACS,  load  JOURNAL,  and  do  M-X  Replay  Journal 
KileKfilenameXerX  The  filename  can  usually  be  omitted  since  normally  you  will  have  used  the  defaults 
when  creating  the  journal. 

After  a  delay  while  the  files,  buffers  and  libraries  arc  loaded  as  they  were  when  the  journal  file  was  written, 
KMACS  will  begin  replaying  the  commands  in  the  journal  before  your  very  eyes.  Unlike  keyboard  macros, 
which  execute  invisibly  until  they  arc  finished,  journal  files  display  as  they  arc  executed.  Iliis  allows  you  to 
see  how  far  the  replay  has  gone.  You  can  stop  the  process  at  any  time  by  typing  CO.  Aside  from  that,  you 
should  not  type  anything  on  the  keyboard  while  the  replay  is  going  on. 

If  the  need  for  a  replay  is  the  result  of  a  system  crash  or  KMACS  crash,  then  you  probably  want  to  replay 
the  whole  file.  This  is  what  happens  naturally.  If  you  arc  replaying  because  you  made  a  great  mistake,  you 
piobably  want  to  stop  (lie  replay  before  the  mistake.  This  is  when  it  becomes  useful  to  type  C-C j  to  stop  the 
replay.  Alternatively,  you  can  edit  the  journal  file,  and  delete  everything  from  the  point  of  tile  mistake  to  the 
end,  before  you  replay  it 
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Once  the  replay  is  complete,  save  all  your  files  immediately.  Don’t  tempt  fate! 

If  you  quit  with  C-G  in  the  middle  of  a  command  while  writing  a  journal  file,  there  is  no  way  to  record  in 
the  journal  file  how  much  of  the  command  has  already  been  completed.  So,  when  die  journal  is  replayed, 
KM  ACS  has  to  ask  you  to  fill  in  for  it.  The  command  which  was  interiupted  will  be  replayed  to  completion; 
then,  you  arc  given  a  recursive  editing  level  in  which  to  restore  the  file  to  the  desired  suite.  This  happens  only 
if  the  C-G  originally  interrupted  an  executing  command.  C-G  typed  to  discard  an  argument  or  partial 
command  while  KMACS  is  waiting  for  input  can  be  and  is  replayed  correctly  without  asking  you  for  help. 

24.4.3.  Journal  File  Format 

To  edit  a  journal  file,  you  must  know  the  format,  it  is  designed  to  be  mostly  transparent. 

The  primary  problem  which  the  journal  file  format  has  to  solve  is  how  to  represent  9-bit  command 
chuructcis  in  a  file  which  can  contain  only  7-bit  ASCII  characters.  (We  could  haw  filled  the  journal  file  with 
9-bit  characteis.  but  then  you  would  not  be  able  to  print  it  out  or  edit  it).  The  solution  we  ha\c  used  is  to 
represent  each  command  by  two  characters  in  the  file. 

So,  a  Control  character  is  represented  by  a  caret  ("*")  folhwcd  by  the  basic  character,  as  in  "~K"  for 
Conlrol-K.  This  was  chosen  to  be  mncmonically  significant.  A  Meta  character  is  represented  by  "  +  " 
followed  by  the  basic  character,  so  that  Mcta-[  is  represented  by  A  Control-Mcta  character  is 

represented  by  followed  by  the  basic  character,  as  in  "*X"  forC-M-X. 

A  command  which  is  not  Control  or  Meta  is  represented  as  a  space  followed  by  the  command  itself,  except 
that  Return  is  represented  by  a  C'RI.K  rather  than  a  space  and  a  carriage  return.  This  prevents  the  journal  file 
from  being  one  huge  line,  and  makes  insertion  of  text  very  recognizable:  tlK  text  inserted  appears  in  the 
journal  file  alternating  with  spaces. 

The  I  lelp  character,  which  is  not  covered  by  the  scheme  as  described  so  far,  is  represented  by 

An  asynchronous  quit,  which  is  a  problem  for  replaying,  is  represented  by  a  single  character,  a  tG,  while  a 
synchronous  quit,  which  can  be  replayed  reliably,  is  represented  by  ":tG".  KMACS  considers  a  quit 
synchronous,  and  uses  ":tG"  to  lecord  it,  if  KMACS  was  waiting  for  terminal  input  when  the  C-G  was  t,pcd. 

Your  commands  themselves  arc  not  the  only  information  in  the  journal  file.  KMACS  records  other 
information  which  is  necessary  in  replaying  the  journal  properly.  The  colon  character indicates  a  block  of 
such  information.  Usually  the  extent  of  the  block  is  easily  recognizable  because  its  contents  do  not  resemble 
the  rcpicscntations  of  commands  described  above.  A  large  block  of  information  starling  with  a  colon  appears 
at  the  beginning  of  every  journal  file. 
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Colons  arc  also  used  to  record  the  precise  effects  of  certain  commands  such  as  C-V  whose  actions  depend 
on  how  the  text  was  displayed  on  the  screen.  Since  the  effects  of  such  commands  arc  not  completely 
determined  by  the  text,  replaying  the  command  could  produce  different  results,  especially  if  done  on  a 
terminal  with  a  different  screen  size.  The  extra  information  recorded  in  the  journal  makes  it  possible  to 
replay  these  commands  with  fidelity. 

A  semicolon  in  the  journal  file  begins  a  comment,  placed  there  for  the  benefit  of  a  human  looking  at  the 
journal.  'Hie  comment  ends  at  the  beginning  of  the  following  line. 

24.4.4.  Warnings 

Proper  replaying  of  a  journal  file  requires  that  all  the  surrounding  circumstances  be  unchanged. 

In  particular,  replaying  begins  by  visiting  all  the  files  that  were  \isited  when  the  writing  of  the  journal  file 
began;  not  the  latest  versions  of  these  files,  but  the  versions  which  were  the  latest  at  the  cm  tier  time.  If  those 
veisions,  which  may  no  longer  be  the  latest,  have  been  deleted,  then  replaying  is  impossible. 

If  your  init  file  has  been  changed,  the  commands  when  replayed  may  not  do  what  they  did  before. 

These  arc  the  only  things  that  can  interfere  with  »eplay:.«g,  as  long  as  you  start  writing  the  journal  file 

* 

immediately  after  starting  HMACS.  Hut  as  an  editing  session  becomes  longer  and  files  arc  saved,  the  journal 
file  contains  increasing  amounts  of  waste  in  the  form  of  commands  whose  effects  arc  already  safe  in  the  newer 
versions  of  the  edited  files.  Replaying  the  journal  will  replay  all  these  commands  wastefuily  to  generate  files 
identical  to  those  already  saved,  before  coming  to  the  last  part  of  the  session  which  provides  the  reason  for 
replaying.  Therefore  it  becomes  very  desirable  to  start  a  new  journal  file.  I  lowcvcr,  many  more  precautions 
must  be  taken  to  insure  proper  replaying  of  a  journal  file  which  is  started  after  HMACS  has  been  used  for  a 
while.  These  precautions  arc  described  here.  If  you  cannot  follow  them,  you  must  make  a  journal  checkpoint 
(see  below). 

If  any  buffer  contains  text  which  is  not  saved  in  a  file  at  the  time  the  journal  file  is  started,  it  is  impossible 
to  replay  the  journal  correctly,  'litis  problem  cannot  possibly  be  overcome.  To  avoid  it,  M-X  Start  Journal 
Pile  offers  to  save  all  buffers  before  actually  shirting  the  journal. 

Another  problem  comes  from  the  kill  ring  and  the  other  ways  in  which  HMACS  remembers  information 
from  previous  commands.  If  any  such  information  which  oiiginaled  before  starting  the  journal  file  is  used 
after  starling  it.  the  journal  file  cannot  he  replayed.  Hor  example,  suppose  you  fill  a  paragraph,  stall  a  journal 
file,  and  then  do  M-X  Undo?  When  the  journal  is  replayed,  it  will  stait  by  doing  M-X  Undo,  but  it  won’t 
know  what  to  undo.  It  is  up  to  you  not  to  do  anything  that  would  cause  such  a  problem.  It  should  not  be 
hard.  It  would  be  possible  to  eliminate  this  problem  by  clearing  out  all  such  d  ita  structures  when  a  journal 
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file  is  stai  ted,  if  users  would  prefer  that. 

A  more  difficult  problem  comes  from  customization,  if  you  change  an  option  or  redefine  a  command, 
then  start  a  journal  file,  the  journal  file  will  have  no  record  of  the  change.  It  will  not  replay  correctly  unless 
you  remember  to  make  the  same  change  beforehand.  Customizations  made  in  an  init  file  do  not  cause  a 
problem  because  the  init  file  has  also  been  run  when  the  journal  file  is  replayed.  Customizations  made 
directly  by  the  user  while  the  journal  file  is  being  written  are  also  no  problem  because  replaying  will  make  the 
same  changes  at  the  right  times.  I  lowcvcr.  a  customization  made  while  a  journal  file  is  being  written  will  be  a 
problem  if  a  new  journal  file  is  started. 


24.4.5.  Journal  Checkpoints 


The  only  cure  for  the  problems  of  starting  a  journal  in  mid-session  is  to  record  the  complete  state  of 
KMACS  at  the  the  time  the  journal  is  begun.  'Ihis  is  not  done  normally  because  it  is  slow;  however,  you  can 
do  (his  if  you  wish  by  giving  M-X  Start  Journal  Hie  a  numeric  argument.  Ihis  writes  the  complete  state  of 
KMACS  into  the  file  <home  directory>:TS  KiSA  VU.  To  replay  the  journal,  um  KSAVK,  the  saved  checkpoint, 
instead  of  l-’MACS;  then  load  JOURNAL  and  do  M-X  Replay  Journal  Hie  as  described  above.  Re  sure  to 
delete  the  checkpoint  if  you  arc  finished  with  it,  since  it  tends  to  be  huge.  Delete  them  also  when  you  logout; 
it  may  be  possible  to  have  a  command  file  which  deletes  them  automatically  when  you  log  out  Checkpoint 
files  more  than  a  day  old  will  probably  be  deleted  by  others  without  notice. 


24.5.  Reporting  Rugs 

There  will  be  times  when  you  encounter  a  bug  in  KMACS.  To  get  it  fixed,  you  must  report  it.  It  is  your 
duty  to  do  so;  but  you  must  know  when  to  do  so  and  how  if  it  is  to  be  constructive. 

24.5.1.  When  Is  There  a  Bug 


If  KMACS  executes  an  llcgal  instruction,  or  dies  with  an  operating  system  error  message  that  indicates  a 
problem  in  the  program  (as  opposed  to  "disk  full"),  then  it  is ccitainiy  a  bug. 

If  KMACS  updates  the  display  in  a  way  that  does  not  correspond  to  what  is  in  the  buffer,  then  it  is 
certainly  a  bug.  Ifa  command  seems  to  do  the  wrong  thing  but  the  problem  is  gone  if  you  type  C-L,  then  it  is 
a  case  of  incorrect  display  updating. 

Taking  foicvcr  to  complete  a  command  can  be  a  bug,  but  you  must  make  certain  that  it  was  really 
KMACSs  fault.  Some  commands  simply  take  a  long  time.  Quit  or  restart  KMACS  and  type  I  Iclp  I.  to  see 
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whclhci  the  keyboard  or  line  noise  garbled  the  input;  if  the  input  was  such  that  you  knutv  it  should  have  been 
processed  quickly,  report  a  bug.  If  you  don’t  know,  try  to  find  someone  who  does  know. 

If  a  command  you  arc  familiar  with  causes  an  KM  ACS  error  message  in  a  ease  where  its  usual  definition 
ought  to  be  reasonable,  it  is  ptobably  a  bug. 

If  a  command  does  the  wrong  thing,  that  is  a  bug.  But  be  sure  you  know  for  certain  what  it  ought  to  have 
done.  If  you  aren't  familiar  with  the  command,  or  don’t  know  for  certain  how  the  command  is  supposed  to 
work,  then  it  might  actually  be  working  right.  Rather  than  jumping  to  conclusions,  show  the  problem  to 
someone  who  knows  for  certain. 

Finally,  a  command's  intended  definition  may  not  be  best  for  editing  with.  This  is  a  scry  important  sort  of 
problem,  but  it  is  also  a  matter  of  judgement.  Also,  it  is  easy  to  come  to  such  a  conclusion  out  of  ignorance  of 
some  of  the  existing  features,  it  is  probably  best  not  to  complain  about  such  a  problem  until  you  have 
checked  the  documentation  in  the  usual  ways  (INFO  and  Help),  led  confident  that  you  understand  it,  and 
know  for  certain  that  what  you  want  is  not  available.  If  you  feel  confused  about  the  documentation  instead, 
then  you  don’t  have  grounds  for  an  opinion  about  whether  the  command's  definition  is  optimal.  Make  sure 
you  read  it  through  and  check  the  index  or  the  menus  for  all  references  to  subjects  you  don’t  fully  understand. 
If  you  have  done  this  diligently  and  arc  still  confused,  or  if  you  finally  understand  but  think  you  could  have 
said  it  better,  then  you  have  a  constructive  complaint  to  make  about  the  documentation.  It  is  just  as  important 
to  report  documentation  bugs  as  program  bugs. 

24.5.2.  I  low  io  Report  a  Bug 

Wb.cn  you  decide  that  there  is  a  bug,  it  is  important  to  report  it  and  to  report  it  in  a  way  which  is  useful. 
What  is  most  useful  is  an  exact  description  of  what  commands  you  type,  starting  with  a  fresh  KM  ACS  just 
loaded,  until  the  problem  happens. 

'Hie  most  important  principle  in  reporting  a  bug  is  to  report  facts,  not  hypotheses  or  conditions.  It  is 
always  casici  to  report  the  facts,  but  people  seem  to  prefer  to  strain  to  think  up  explanations  and  report  them 
instead.  If  the  explanations  arc  based  on  guesses  about  how  KM  ACS  is  implemented,  they  will  be  useless;  we 
will  have  to  try  to  figure  out  what  the  facts  must  have  been  to  lead  to  such  speculations.  Sometimes  this  is 
impossible.  But  in  any  case,  it  is  unnecessary  work  for  us. 

For  example,  suppose  that  you  type  C-X  C-V  Cil.ORIFBA/.  UG!Kcr>,  visiting  a  file  which  (you  know) 
happens  to  be  rather  large,  and  KM  ACS  prints  out  "I  feel  pretty  today".  'Hie  best  way  to  report  the  bug  is 
with  a  sentence  like  the  preceding  one,  because  it  gives  all  the- facts  and  nothing  but  the  facts. 

Do  not  assume  that  the  problem  is  due  to  the  size  of  the  file  and  say  "When  I  visit  a  large  file,  KMACS 
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prints  oui  ’!  feel  pretty  today’".  This  is  what  we  mean  by  "guessing  explanations".  ITie  problem  is  just  as 
likely  to  be  due  to  the  fact  that  there  is  a  "/."  in  the  filename.  If  this  is  so.  then  when  we  got  uuir  report,  we 
would  try  out  tlic  problem  with  son.o  "big  file",  probably  with  no  "Z”  in  its  name,  and  not  find  anything 
wrong.  There  is  no  way  in  the  world  that  we  could  guess  that  we  should  try  \isiting  a  file  with  a  "Z"  in  its 
name. 

Alternatively,  the  problem  might  be  due  to  the  fact :  wt  the  file  starts  with  exactly  25  spaces.  For  this 
reason,  you  should  make  sure  that  you  don’t  change  the  fiY  until  we  have  looked  at  it.  Suppose  the  problem 
only  occurs  when  you  have  typed  the  C-X  C-A  command  previously?  This  is  why  we  ask  you  to  give  the 
exact  sequence  of  characters  you  typed  since  loading  the  KM  ACS. 

You  should  not  even  say  "visit  the  tile  ..."  instead  of  "C-X  C-V"  unless  you  know  that  it  makes  no 
difference  which  visiting  command  is  used.  Similarly,  rather  than  saying  "if  I  have  three  characters  on  the 
line",  say  "after  I  type  <cr>  A  It  C  <cr>  C-P",  if  that  is  the  way  you  entered  the  text.  A  journal  file  containing 
the  commands  you  typed  to  reproduce  the  bug  is  a  very  good  form  of  report. 

Send  the  bug  report  to  1HJG-KMACS^'MIT-A1  if  you  are  on  the  A i panel  or  to  the  author  (sec  the 
preface  for  the  address). 

If  you  arc  not  in  Fundamental  mode  when  the  problem  occurs  you  should  say  what  mode  you  arc  in. 

He  sure  to  say  what  version  of  KMACS  and  TKCO  aie  running.  If  you  don’t  know,  type  Mcla-Altmodc 
QHMACS  Version^-  FS  Version^  ♦♦  and  KMACS  will  print  them  out.  (‘litis  is  a  use  of  the  minibuffer. 
See  section  23  [Minibuffer],  page  127.) 

If  the  bug  occurred  in  a  customized  KMACS,  or  with  several  optional  libraries  loaded,  it  is  helpful  to  try  to 
reproduce  the  bug  in  a  more  standard  KMACS  with  fewer  libraries  loaded.  It  is  best  if  you  can  make  the 
problem  happen  in  a  completely  standard  KMACS  with  no  optional  libraries.  If  the  problem  docs  not  occur 
in  a  standard  KMACS,  it  is  very  important  to  report  that  fact,  because  otherwise  we  will  try  to  debog  it  in  a 
standard  KMACS,  not  find  the  problem,  ami  give  up.  If  the  problem  does  depend  on  an  init  file,  then  you 
should  make  sure  it  is  not  a  bug  in  the  init  file  by  complaining  to  the  person  who  wrote  the  file,  first.  He 
should  check  over  bis  code,  and  verify  the  definitions  of  the  TKCO  commands  be  is  using  by  looking  in 
INFO;TKCORI)  >.  Then  if  he  verifies  that  the  bug  is  in  KMACS  he  should  report  it.  We  cannot  be 
responsible  for  maintaining  users*  init  tiles:  we  might  not  even  be  able  to  tell  wh.it  they  are  supposed  to  do. 

If  you  can  tell  us  a  way  to  cause  the  problem  without  reading  in  any  files,  please  do  so.  ’Iliis  makes  it  much 
easier  to  debug.  If  you  do  need  files,  make  sure  you  arrange  for  us  to  see  their  exact  contents.  For  example,  it 
can  often  matter  whether  there  arc  spaces  at  live  ends  of  lines,  or  a  line  separator  after  the  last  line  in  the 
buffer  (nothing  ought  to  care  whether  the  last  line  is  terminated,  but  tell  that  to  the  bug0.). 
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If  HMACS  gets  an  operating  system  error  message,  such  as  for  an  illegal  instruction,  then  you  can  probably 
recover  by  restarting  it.  But  before  doing  so,  you  should  make  a  dump  file.  Do  this  by  saying  :PI)UMP 
CRASHtHMACS  >.  tic  sure  to  report  exactly  all  the  numbers  printed  out  with  the  error  message.  Also  type 
.JPC7  and  include  DDTs  response  in  your  report.  If  you  restart  or  continue  the  HMACS  before  saving  this 
information,  the  trail  will  be  covered  and  it  will  probably  be  too  late  to  find  out  what  happened. 

•\  dump  is  also  useful  if  HMACS  gets  into  a  wedged  state  in  which  commands  that  usually  work  do  strange 
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25.  Word  Abbreviation  Input 

Word  Abbrev  mode  allows  the  KMACS  user  to  abbreviate  text  with  a  single  "word",  with  KMACS 
expanding  the  abbreviation  automatically  as  sout  as  you  have  finished  the  abbreviation,  with  cont:o!  over 
capitalization  of  die  expanded  string. 

Abbrevs  arc  also  useful  for  correcting  commonly  misspelled  or  mistyped  words  (c.g.  "tliier"  could  expand 
to  "their"),  and  for  uppercasing  words  like  "KMACS"  (abbrev  "emacs"  could  expand  to  "KMACS"). 

To  use  this  mode,  just  do  M-X  Word  Abbrev  Modc<cr>.  (Another  M-X  Word  Abbrev  Mode<cr>  will  turn 
the  mode  off;  it  toggles.) 

l  or  example,  in  waiting  this  documentation  I  could  have  defined  "wain"  to  be  an  abbreviation  for  "word 
abbrev  mode".  After  only  typing  the  letters  "wain".  I  see  just  that.  "want",  but  if  1  then  finish  the  word  by- 
tv  oing  space  oi  period  or  any  of  the  text  break-characters,  the  "wain"  is  replaced  by  (and  redisplays  as)  "word 
abbrev  mode".  If  I  capitalize  the  abbrev,  "Wain",  the  expansion  is  capitalized:  "Word  abbrev  mode".  If  1 
capitalize  the  whole  abbrev,  WAM".  each  word  in  the  expansion  is  capitalized:  "Word  Abbrev  Mode".  In 
this  partk  uiar  example,  though  I  would  define  "warn"  to  expand  to  "Word  Abbrev  mode"  since  it  is  always 
to  be  capitalized  that  way. 

Tims.  1  can  type  "1  am  in  warn  now"  and  end  up  with  "1  am  in  Word  Abbrev  mode  now”. 

Word  Abbrev  mode  docs  not  interfere  with  the  use  of  major  modes,  c.g.  Text.  Lisp.  TKCO,  PI. I,  or  minor 
modes,  e.g.  Auto  Fill.  Those  modes  (or  the  user)  may  redefine  what  functions  arc  to  be  called  by  characters; 
Unit  docs  not  interfere  with  Word  Abbrev  mode. 

Ilicrc  arc  two  kinds  of  word  abbreviations:  mode  and  global.  A  inode  word  abbrev  causes  expansion  in 
only  one  major  mode  (for  instance  only  in  Text  mode),  while  a  global  word  abbrev  causes  expansion  in  all 
major  modes.  If  some  abbrev  is  both  a  mode  word  abbrev  for  the  cuircnl  mode  and  a  global  word  abbrev, 
the  mode  word  abbrev  expansion  takes  precedence. 

For  instance,  you  might  want  an  abbrev  "foo"  for  "find  outer  otter”  in  1'cxt  mode,  an  abbrev  ’Too"  for 
"1'INAGi.K-OPPOSlNG-OlMNlONS"  in  Lisp,  and  an  abbrev  ’Too"  for  "meta-syntactic  variable"  in  any 
other  mode  (the  global  word  abbrev). 

Word  abbrevs  can  be  defined  one  at  a  time  (adding  them  as  you  think  of  them),  or  many  at  a  time  (from  a 
definition  list).  You  can  save  them  in  a  file  and  re;..’  them  back  later.  Word  abbrev  definitions  stay  around 
even  while  you’re  not  in  Word  Abbrev  mode,  though  they  don’t  expand. 
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Word  abbrevs  can  be  killed  either  singly,  or  by  editing  the  current  definition  list 


25.1.  Basic  Usage 

C-X  C-A  Define  a  inode  abbrev  for  some  text  before  point 

C-X  t  Define  a  global  abbrev  for  some  text  before  point. 

C-X  C-l  l  Define  expansion  for  mode  abbrev  before  point. 

C-X  -  Define  expansion  for  global  abbrev  before  point 

C-M-Spacc  Hxpand  abbrev  without  inserting  anything. 

M-’  Mark  a  prefix  to  be  glued  to  an  abbrev  following. 

C-X  U  Unexpand  the-  last  abbrev.  or  undo  a  C-X  U. 

M-X  l  ist  Word  Abbrcvs<cr> 

Shows  definitions  of  all  abbrevs. 

M-X  l'dit  Word  Abbrcvs<cr> 

i.ets  you  edit  the  definition  list  directly. 

M-X  Read  Word  Abbrev  i'ilcKfilcnamcXcr> 

Defines  word  abbrevs  from  a  definition  file. 

M-X  Write  Woid  Abbrev  FilcKfilcnameXcr> 

Makes  a  definition  file  from  current  abbrev  definitions. 

Readable  Word  Abbrev  Files 

Option  variable  to  control  abbrev  file  format 

’lliis  section  describes  the  most  common  use  of  Word  Abbrev  inode.  If  you  don’t  read  any  more  than  this, 

you  can  still  use  Word  Abbrev  mode  quite  effectively. 


25.1.1.  Adding  Word  Abbrevs 

C-X  C-A  (~R  Add  Mode  Word  Abbrev)  defines  a  mode  abbrev  for  die  word  before  point  (this  docs  not 
include  any  punctuation  between  that  word  and  point,  though),  it  prints  the  word  before  point  in  the  echo 
area  and  ask  you  for  that  word’s  abbreviation.  Type  the  abbrev  (in  die  echo  area,  editing  a  little  with  Rubout 
and  C-U)  followed  by  a  Return.  ’Hie  abbrev  must  be  a  ‘’word”:  it  must  contain  only  letters  and  digits.  If 
you'd  lather  define  a  global  abbrev.  use  C-X  4  (“R  Add  Global  Word  Abbrev),  which  works  similarly. 

You  can  redefine  an  abbrev  by  C-X  C-A  or  C-X  -K  but  it  tells  you  the  old  expansion  and  ask  you  to 
confirm  the  redefinition.  Type  Y  or  N. 

To  define  an  abbrev  for  moic  than  one  word  of  text,  give  C-X  C-A  or  C-X  +  a  numeric  argument:  an 
argument  greater  than  0  means  the  expansion  is  that  many  words  before  point;  an  argument  of  0  means  to  use 
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the  region  (between  point  and  mark).  (By  using  the  region  specification  you  can  make  an  abbrev  for  any  text, 
not  just  a  sequence  of  words.)  Hie  message  in  the  echo  area  provides  you  with  confirmation  of  just  what  the 
expansion  will  be;  e.g.  you  might  see: 

Text  Abbrev  for  "this  is  the  expansion": 

Sometimes  you  may  think  you  already  had  an  abbrev  for  some  text,  use  it.  and  see  that  it  didn’t  expand.  In 
this  ease,  the  C-X  C-H  ("It  Inverse  Add  Mode  Word  Abbrev)  or  C-X  -  ("R  Inverse  Add  Global  Word 
Abbrev)  commands  arc  helpful:  they  ask  you  to  type  in  an  expansion  rather  than  an  abbrev.  In  addition  to 
defining  the  abbrev,  they  also  expand  it  If  you  give  them  a  numeric  argument,  n.  they  use  the  nth  word 
before  point  as  the  abbrev. 

You  can  kill  abbrevs  (cause  them  to  no  longer  expand)  by  giving  a  negative  numeric  argument  to  C-X  C*A 
or  C-X  +.  For  instance.  to  kill  the  global  abbrev  “foo"  type  C-U-  C-X  +  foo<cr>. 


25.1.2.  Controlling  Abbrev  Expansion 

When  an  abbrev  expands,  die  capitalization  of  die  expansion  is  determined  by  die  capitalization  of  die 
abbrev:  If  the  abbrev  is  all  lowercase,  the  expansion  is  as  defined.  If  the  abbrev’s  1st  letter  is  uppercase,  the 
expansion's  1st  leu-  r  is  too.  If  die  abbrev  is  all  uppercase,  there  arc  tv.o  possibilities:  if  the  expansion  is  a 
single  word,  it  is  aii-uppcrcascd:  otherwise,  each  of  its  words  has  iLs  first  letter  uppercased  (e.g.  for  use  in  a 
title). 

Abhrevs  normally  expand  when  you  type  some  punctuation  character;  the  abbrev  expands  and  the 
punctuation  character  is  inserted.  'Ihcrc  arc  other  ways  of  expanding  abbrevs:  C-M-Spacc  (~R  Abbrev 
Fxpand  Only)  causes  die  abbrev  just  before  point  to  be  expanded  without  inserting  any  other  character.  M-’ 
("R  Word  Abbrev  Prefix  Mark)  allows  you  to  "glue"  an  abbrev  onto  any  prefix:  suppose  you  have  the 
abbrev  "committee"  for  "committee”,  and  wish  to  insert  "intcrcommittcc  type  "inter",  M-*  (you  will  now 
see  "inter-"),  and  then  "committee  "intcr-cpmin  "  becomes  "intcrconuniltcc  ”. 

25.13.  Unexpwitling  Abbrevs 

C-X  U  ("R  Unexpand  last  Word)  "unexpands"  the  last  abbrevs  expansion,  replacing  die  last  expansion 
with  the  abbrev  that  caused  it.  If  any  auto-lilling  was  done  because  of  the  expansion  (you  had  Auto  Mil  mode 
on),  that  too  is  undone.  If  you  type  anodier  C-X  U,  the  first  one  is  "undone"  and  the  abbrev  is  expanded 
again.  (Sometimes  you  may  find  that  C-X  U  uncxpnnds  an  abbrev  latcr  than  the  one  you’re  It  Hiking  at.  In 
this  ease,  do  another  C-X  U  and  go  back  and  manually  correct  the  earlier  expansion.  Only  me  first  expansion 
can  be  undone.) 
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If  you  know  bcfoi  ehand  :liat  a  word  will  expand,  and  want  to  prevent  it.  you  can  simply  "quote"  the 
punctuation  character  with  C-Q-  f-.g  typing  "comm",  a  C-Q.  and  then  gives  “comm."  without 
expanding. 


25.1.4.  Listing  \bbrcvs 

M-X  List  Word  Abbrevs  lists  all  currently  defined  abbrevs.  An  abbrev  "foo”  that  expands  to  "this  is  an 
abbicv”  in  Text  mode  and  has  been  expanded  )  (the  "usage  count")  times,  is  listed  as: 
foo:  (Text)  3  “this  is  an  abbrev" 

An  abbrev  "gfoo"  which  expands  to  "this ::: ::  global  abbrev"  in  all  modes,  expanded  1 1  times,  is  listed  as: 
gfoo:  It  "this  is  a  global  abbrev” 

Note  that  any  use  of  the  double-quote  character  (”)  inside  an  expansion  is  doubled,  io  distinguish  the  use 
of"  from  the  "s  that  surround  the  whole  expansion.  Thus  if  the  global  abbrev  'hclpk'  expands  to  *th*.  "Help" 


character',  it  :s  listed  as- 
helpk: 


"the  ""Help""  character" 


25. 1.5.  Editing  the  Definition  List  ' 

M-X  l-dit  Word  Abbrevs  places  you  in  a  recursive  editing  level,  editing  the  current  word  abbrev  definition 
list.  The  abbrevs  appear  in  the  same  format  used  by  i.ist  Word  Abbrevs.  When  you  exit  (via  C-M-C).  the 
current  word  abbrevs  will  be  redefined  from  the  edited  definition  list:  any  abbrevs  that  have  been  deleted 
from  the  list  are  killed,  new  ones  added  to  the  list  arc  defined,  and  old  ones  changed  arc  modified.  In  effect, 
after  exiting  the  Ldil  Word  Abbrev  editing  level,  all  previously-defined  word  abbrevs  arc  killed,  and  the 
edited  list  is  used  to  define  new  abbrevs.  Typing  C-J  (Abort  Recursive  lidit)  aborts  i'dit  Word  Abbrevs. 
without  killing  or  redefining  any  abbrevs. 


25.1.6.  Saving  Abbrev  Definitions 

M-X  Write  Word  Abbrev  l-lleK!i!cnumcXcr>  writes  .in  "abbrev  definition  file"  which  contains  cite 
definitions  of  all  the  abhievs  in  your  l-MACS  ihiw.  M-X  Read  Word  Abhiei  !-lh*XfilenaincXcr>  reads  in 
such  a  file  and  defines  the  abbrevs.  (Other  abbrevs  already  defined  arc  not  aficctcd  unless  the  file  redefines 
them.)  If  you  don't  supply  a  filename,  the  last  one  you  used  in  either  of  these  is  used  again,  originally 
defaulting  to  WORDAH  DHI-'NS.  With  these  two  commands,  you  can  save  die  abbrevs  you  defined  in  one 
l-MACS  and  restore  them  in  another  l-MACS  another  day. 


f,  rM1'  v/  vn1  ;v  ^  .  i 
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The  format  of  the  definition  file  is  designed  for  fast  loading,  not  case  of  human  roadability.  (But  if  you 
have  to,  you  can  figure  it  out  enough  to  read  or  even  edit  it.)  if  you  want  M-X  Write  Word  Abbrcv  File  to 
write  a  human-readable  version  instead,  set  the  option  Readable  Word  Abbrcv  Files  to  1.  (M-X  Read  Word 
Abbrcv  File  will  be  able  to  icad  this,  but  not  as  fast.) 

If  you  have  an  init  file,  you  might  want  to  put  THCO  code  like  the  following  into  it,  in  order  to  turn  on 

Woid  Abbrcv  mode  and  have  your  abbrcv  definition  file  automatically  read  when  liMACS  stmts  up: 

lin(m. mWord  Abbrev  Mode$) 

m(m.iiiRead  Word  Abbrev  File$)WORDAB  DEFNSf 


25.2.  Advanced  Usage 

The  use  of  Word  Abbrev  mode  as  discussed  in  the  previous  section  suffices  for  most  users.  I  lowcvcr,  some 
uscis  who  use  Word  Abbrev  inode  a  lot  or  have  highly  tailored  environments  may  desire  more  flexibility,  or 
need  more  power  to  handle  extreme  situations,  than  the  basic  commands  provide. 

25.2.1.  Alternatives  and  C'lisloinizations 

M-X  Make  Word  Al)brcvKabbrev>Kcxpansion>Kmodc><cr> 

M-X  Kill  All  Word  Abbrcvs<cr> 

M-X  Make  These  Characters  F.xpandKcharactersXcr> 

aR  Kill  Mode  Word  Abbrcv 

~R  Kill  Global  Word  Abbrev 

Only  Global  Abbrevs 

Option  variable  if  you  only  uscglobals. 

Additional  Abbrev  Hx panders 

Variable  for  adding  a  few  more  expanders. 

WORDAB  Ins  Chars 

Variable  for  replacing  entire  set  of  expanders. 

The  basic  commands  for  defining  a  new  mode  abbrcv,  C-X  C-A  ('"R  Add  Mode  Word  Abbrev)  and  C-X 
C-H  ("R  Inverse  Add  Mode  Word  Abbrcv),  work  only  in  the  current  mode.  A  more  general  command  is 
M-X  Make  Word  Abbrcv  which  takes  three  string  arguments:  the  first  is  the  abbrcv,  the  second  is  the 
expansion,  and  the  third  is  the  mode  (c.g.  "Text").  This  command  can  also  define  global  abbrevs,  by 
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providing  as  the  mode  name. 

M-X  Kill  All  Word  Abbrcvs<cr>  is  a  very  quick  way  of  killing  every  abbrev  currently  defined.  After  this 
command,  no  abbrev  will  expand.  (A  slower  but  more  careful  way  is  with  M-X  Kdit  Word  Abbrevs.) 

The  functions  AR  Kill  Mode  Word  Abbrev  and  *R  Kill  Global  Word  Abbrev  exist,  but  arc  not  attached  to 
any  commands  by  default.  If  you  want  to  avoid  specifying  negative  arguments  to  C-X  C-A  (AR  Add  Mode 
Word  Abbrev)  and  C-X  +  (*R  Add  Global  Word  Abbrev),  you  should  attach  these  functions  to  characters. 
You  could  use  the  function  M-X  Set  Key  (See  section  5.2  {Set  Key),  page  21.)  to  do  this  or  have  an  init  or 
KVAKS  file  set  them  (See  section  22.7  (Init),  page  120.). 

If  you  prefer  to  use  only  global  abbicvs  then  you  should  set  the  option  variable  Only  Global  Abbrevs  to  1. 
You  can  do  this  after  or  before  turning  on  Word  Abbrev  mode;  it  makes  no  diffeicnec.  This  causes  the  global 
nhhiev  defiuers  which  would  otherwise  be  on  C-X  r  CR  Add  Global  Word  Abbrev)  and  C-X  -  (AR  Inverse 
Add  Global  Wotd  Abbrev)  to  be  on  the  easier  to  type  characters  C-X  C-A  and  C-X  C-ll.  In  addition,  the 
checking  done  whenever  you  type  an  expander  character  (c.g.  the  punctuation  characters)  us  about  three 
times  lastc!  (for  the  no-expansion  case,  which  is  what  happens  most  of  the  lime). 

Noimally,  the  following  chat acters  cause  expansion  (followed  by  whatever  they  would  normally  do  were 
Word  Abbiev  mode  off  c.g.  insert  themselves):  !~<?/'# ;$%''&*-_=  +D()\|:'"{ },<.>'/?  and  Space,  Return, 
and  Tab.  You  can,  however,  specify  additional  characters  to  cause  expansion  (digits,  for  instance,  or  grcck 
letters  on  keyboards  with  Top-keys).  M-X  Make  These  Characters  HxpandKcharactcrsXcr>  adds  the 
characters  in  the  string  argument  to  the  list  of  expanders.  Alternatively,  easier  for  init  and  KVARS  files,  you 
can  set  the  variable  Additional  Abbiev  Kxpanders  to  contain  the  string  of  characters.  If  you  wish  to 
completely  replace  the  set  of  characters  that  cause  expansion,  set  the  variable  WORDAB  Ins  Chars  in  your 
init  file.  See  section  22.7  (init).  page  120,  for  details  on  siting  variables  in  init  and  KVARS  files. 

25.2.2.  Manipulating  Definition  Lists 

One  reason  some  users  have  for  manipulating  the  definition  lists  is  to  piovidc  more  structure  to  the 
definition  environment  than  just  the  mode-global  structure  provided  normally,  c.g.  to  group  togethei  in  a  tile 
those  abbrevs  pertaining  to  one  topic. 

M-X  Insert  Word  Abbrcvs<cr>  inserts  into  the  buffer  a  list  of  the  current  woul  abbrev  definitions,  in  the 
format  that  M-X  I  ist  Word  Abbrevs  uses. 

M-X  Define  Word  Abbrcvs<cr>  defines  a  set  of  word  abbrevs  fiom  a  definition  list  in  the  buffer.  'Ilicrc 
should  be  nothing  else  besides  the  definition  list  in  the  buffer;  or,  iftthcre  is,  you  must  narrow  the  buffer  to 
just  the  definition  list.  See  section  17  (Narrowing),  page  77.  | 
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25.2.3.  Dealing  with  Many  Abbrevs 

Some  use:s  rapidly  build  up  a  very  large  number  of  abbrevs.  This  causes  a  couple  of  problems  that  have  to 
be  dealt  with  in  ways  not  discussed  in  the  basic  usage  section:  First,  defining  all  those  abbrevs  when  I  {MACS 
shirts  up  can  become  too  slow;  this  problem  is  discussed  in  the  next  section.  Second,  the  commands  that  deal 
with  the  definition  lists  become  unwieldy.  The  current  release  of  the  Word  Abbrev  mode  paciaigc  only  has 
one  command  directly  dealing  with  large  definition  lists: 

M-X  Word  Abbrev  AproposKstringXcr>  shows  you  the  definitions  of  just  the  abbrev  definitions 
containing  <string>  (in  the  abbrev,  in  the  mode,  or  in  the  expansion).  Tlic  aigument  is  actually  a  TRCO 
seaich  suing  (See  section  19.3  (TF.CO  search  strings],  page  85.).  If  you  want  to  sec  the  abbrevs  which  contain 
either  <stringl>  or  <string2>,  separate  the  stiings  with  a  C'ontrol-0;  c.g.  to  see  abbrev  definitions  containing 
either  "defn"  or  "wab".  do  M-X  Word  Abbrev  Apmpos+dcfntOwab<cr>. 

M-X  Word  Abbrev  Apropos  only  works  "approximately"  though:  it  may  miss  some  definitions  (those 
defined  by  Fdit  Word  Abbrevs.  Define  Word  Abbrevs,  or  human-readable  definition  files),  and  it  may  also 
find  more  than  you  want  in  some  rare  cases.  These  problems  are  all  related  to  efficiency  questions. 

25.2.4.  Dumped  EM  ACS  Environments 

M-X  Write  Word  Abbrev  FilcXfilcnamcXcr> 

Writes  a  file  of  all  abbrev  definitions,  before  dumping. 

M-X  Read  Word  Abbrev  FilcKfilcnamcXcr) 

Reads  file  of  abbrev  definitions  at  init-time. 

M-X  Write  Incremental  Word  Abbrev  FilcKfilcnamcXcr> 

Writes  a  file  of  changed  abbrev  definitions,  since  dumping. 

M-X  Read  Incremental  Word  Abbrev  FilcKfilcnamcXcr> 

Reads  file  of  changed  abbrev  definitions  at  startup-time. 

Some  users  with  highly  customized  KM  ACS  environments  (their  init  files  take  a  long  time  to  run)  "dump 
out"  their  environments,  in  effect  creating  another  KMACS-like  program  (the  "dump")  which  starts  up  much 
faster.  (For  instance,  1.7  epu  seconds  instead  of  70.5  cpi:  seconds.  See  the  file  INI;0:C0NV  >.  for  more 
details  about  dumping  environments.)  Since  the  dumped  environment  contains  woid  abbrev  definitions,  a 
dumped  environment  with  hundreds  of  abbrevs  can  start  just  as  quickly  as  if  it  had  none.  (Rut  reading  all 
these  abbrevs  with  M-X  Read  Word  Abbrev  File  in  the  init  file  originally  took  a  long  time.)  finis  for  these 
users,  it  is  important  that  at  dump-startup  time,  only  to  read  in  those  abbrevs  which  were  changed  or  defined 
since  the  environment  was  dumped  out.  A  file  which  contains  only  these  new  ahbrev's  definitions  is  called  an 
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incremental  word  abbrev  file.  (It  also  can  specify  that  certain  abbrevs  arc  to  be  killed  if  they  were  defined 
when  the  environment  was  dumped  out,  but  subsequently  killed.) 

The  startup  for  the  dump  should  use  the  Read  Incremental  Word  Abbrev  Hie  function  instead  of  Read 
Word  Abbrev  File.  It  takes  die  filename  as  a  string  argument,  which  defaults  to  INCABS  >.  'Hie  command 
M-X  Write  Incremental  Word  Abbrev  FilcKfiicnamcXcr>  writes  such  a  file,  writing  out  those  abbrevs  more 
recent  than  the  dump  (including  ones  read  by  Read  Incremental  Word  Abbrev  File  and  ones  defined  in  the 
current  editing  session).  You  might  want  to  call  this  command  after  defining  some  abbrevs,  before  exiting 
(■MACS.  (Plans  arc  afoot  to  have  this  be  done  automatically  as  an  option.) 

When  you  want  to  dump  out  a  new  HMACS.  first  create  a  new,  complete  word  abbrev  definition  file  using 
M-X  Write  Word  Abbrev  File.  This  file  now  has  all  abbrevs  in  it.  and  you  can  thus  delete  any  incremental 
defiirtion  files  you  have.  Then  start  up  the  now  F'MACS  from  scratch,  using  the  inil  file,  and  dump  it.  (The 
i;.it  file  in  general  should  call  Read  Word  Abhrev  Kile  and  then  also  call  Read  Incremental  Word  Abbrev 
F  ile,  just  in  ease  there  arc  both  kinds  of  files  around.  'Hie  startup  calls  only  Read  Incremental  Word  Abbrev 
File.)  Note  that  to  handle  the  possibility  of  die  incremental  file  not  existing,  the  TI-C'O  code  in  the  slat  tup 
subroutine  can  look  like  (though  soon  this  won’t  be  necessary): 
e?<f  i  lenaine>$"e 

m(in.inRead  Incremental  Word  Abbrev  Fi  1e*)<f  i  1ename>+* 

25.3.  Teco  Details  for  Extension  Writers 

This  section  documents  some  details  diat  users  programming  extensions  may  need  to  know,  in  order  to 
interact  piopcrly  with  Word  Abbrev  mode  operation  or  to  build  upon  it 

There  arc  two  hooks  dial  you  can  provide:  'Hie  variable  WORDAB  Setup  Hook,  if  non-0,  is  executed 
when  the  WORDAB  library  is  loaded  and  sets  itself  up.  (M-X  Word  Abbrev  Modc<cr>  in  the  default 
F'MACS  environment  auto-loads  the  WORDAB  library.) 

The  variable  Word  Abbrev  I  look,  if  non-0,  is  executed  when  Word  Abbrev  mode  is  turned  on  or  off.  It  is 
passed  a  numeric  argument  which  is  positive  if  Word  Abbrev  mode  is  being  turned  on,  and  0  or  negative  if  if. 
is  being  turned  off.  Also,  if  this  hook  exists,  Word  Abbrev  mode  does  not  redefine  any  characters;  it  assumes 
the  hook  will  do  that.  Thus  C-X  C-A,  C-X  C-H,  C-X  +,  C-X  -,  M-\  C-M-Spacc,  and  C-X  U  will  not  be 
bound  unless  the  hook  binds  them. 

The  abbrev  definers,  c.g.  C-X  C-A  ("R  Add  Mode  Word  Abbrev),  check  to  see  if  the  volatile  i'i-CO  mark, 
fs^RMark*,  is  set;  if  it  is,  then  the  region  between  point  and  fs~RM<trk+  is  used  as  the  expansion.  'Die 
intention  is  to  provide  a  mechanism  for  simple  but  safe  expansion  marking. 
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Finally,  the  general  way  that  Word  Abbrev  mode  works  is  this:  at  certain  times,  when  characters  are  likely 
to  have  been  reconnected,  a  Word  Abbrev  mode  subroutine  looks  at  each  of  the  expander  characters  to  see  if 
they  arc  running  jii  expander  or  have  been  rebound.  If  they  don’t  have  expanders,  they  arc  reset  to  an 
expander  function  (which  first  checks  for  expansion  and  then  calls  the  "old"  function,  what  the  character  was 
bound  to  before).  The  problem  is  that  it  is  not  really  possible  to  efficiently  catch  all  the  times  that  characters 
of  interest  arc  rebound.  So.  as  a  good  guess.  Word  Abbrev  mode  looks  at  these  characters  when  the  &  Set 
Mode  Line  function  is  called.  'Hiis  happens  when  major  or  minor  modes  change,  when  buffer  switching 
happens,  and  when  Set  Key  is  used.  'Ilicsc  arc  the  standard  times  that  connections  arc  changed.  However, 
the  extension  writer  must  be  careful  about  rebinding  expander  characters.  If  an  extension  might  do  this,  it 
should  do  1  fsModc  Change*  to  cause  expansions  to  be  redefined. 
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26.  The  PICTURE  Subsystem,  an  Editor  for  Text  Pictures 

if  you  want  to  create  a  picture  made  out  of  text  characters  (for  example,  a  picture  of  the  division  of  a 
register  into  fields,  as  a  comment  in  a  program),  the  PICfURH  package  can  make  it  easier. 

Do  M-X  Load  Lib>PICTURK<cr>.  and  then  M-X  Hdit  Picture  is  available.  Do  M-X  Hdit  Picture  with 
point  and  mark  surrounding  the  picture  to  be  edited.  Hdit  Picture  enters  a  recursive  editing  level  (which  you 
exit  with  C-M-C,  as  usual)  in  which  certain  commands  are  redefined  to  make  picture  editing  more 
convenient 

While  you  arc  inside  Hdit  Picture,  all  die  lines  of  the  picture  are  padded  out  to  the  margin  with  spaces. 
This  makes  two-dimensional  motion  very  convenient;  C-B  and  CT‘  move  horizontally,  and  C-N  and  OP 
move  vertically  without  the  inaccuracy  of  a  ragged  right  margin.  When  you  exit  from  Hdit  Picture,  spaces  at 
die  ends  of  lines  are  removed.  Nodiing  stops  you  from  moving  outside  the  bounds  of  the  picture,  but  if  you 
make  any  changes  there  slightly  random  things  may  happen. 

I'dit  Picture  makes  alteration  of  the  picture  convenient  by  redefining  the  way  printing  characters  and 
Rubout  work.  Printing  characters  arc  defined  to  replace  (overwrite)  rather  than  insetting  themsclvps. 
Rollout  is  defined  to  undo  a  printing  character;  it  replaces  the  previous  character  with  a  space,  and  moves 
back  to  it 

Return  is  defined  to  move  to  the  beginning  of  the  next  line.  This  makes  it  usable  for  moving  to  the  next 
apparently  blank  (but  actually  filled  with  nothing  but  spaces)  line,  just  as  you  use  Return  normally  widi  lines 
diat  arc  really  empty.  C-0  creates  new  blank  lines  after  point,  but  they  arc  created  full  of  spaces. 

Tab  is  redefined  to  indent  (by  moving  over  spaces,  not  inserting  them)  to  under  the  first  non-space  on  the 
prev  ious  line.  Linefeed  is  as  usual  equivalent  to  Return  followed  by  Tab. 

Four  movement-control  commands  exist  to  aid  in  drawing  vertical  or  horizontal  lines:  If  you  give  die 
command  M-X  Up  Picture  Movement,  each  character  you  type  thereafter  will  cause  the  cursor  to  move  up 
instead  of  to  the  right.  'Ihus  if  you  want  to  draw  a  line  of  dashes  up  to  some  point,  you  can  give  the  command 
lip  Picture  Movement,  type  enough  dashes  to  make  the  line,  and  then  give  die  command  Right  Picture 
Movement  to  put  tilings  hack  to  normal.  Similarly,  there  arc  functions  to  cause  downward  and  leltward 
movement:  Down  Picture  Movement  and  Left  Picture  Movement.  'Ihesc  commands  remain  in  effect  only 
until  you  exit  the  Hdit  Picture  function,  (One  final  note:  you  can  use  these  cursor  movement  commands 
outside  of  Hdit  Picture  too,  even  when  not  in  Overwrite  mode.  You  have  to  be  somewhat  careful  though.) 


Possible  fuliuc  extensions  include  alteration  of  the  kill  and  un-kill  commands  to  replace  instead  of  deleting 
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inserting,  and  to  handle  rectangles  if  two  corners  arc  specified  using  point  and  the  mark. 
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27.  Sorting  Functions 

The  SORT  library  contains  functions  called  Sort  Tines,  Sort  Paragraphs  and  Sort  Pages,  to  sor*  the  region 
alphabetically  line  by  line,  paragraph  by  paragraph  or  page  by  page.  For  example.  Sort  Tines  rearranges  the 
lines  in  the  region  so  that  they  arc  in  alphabetical  order. 

Paragraphs  arc  defined  in  the  same  way  as  for  the  paragraph-motion  functions  (See  section  1 1.2 
{Paragraphs],  page  44.)  and  pages  arc  defined  as  for  the  page  motion  commands  (See  section  18  {Paging], 
page  79.).  All  of  these  functions  can  be  undone  by  the  Undo  command  (See  section  24.3  {Undo],  page  132.). 
They  hike  no  arguments. 
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].l.  ideal  Keyboards 

An  ideal  I -MACS  keyboard  can  be  recognized  because  it  has  a  Control  key  and  a  Meta  key  on  each  side, 
with  another  key  labelled  Top  above  them. 

On  an  ideal  keyboard,  to  type  any  character  in  the  9-bit  character  set,  hold  down  Control  or  Meta  as 
appropriate  while  typing  the  key  for  the  rest  of  the  character.  To  type  C-M-K,  type  K  while  holding  down 
Control  and  Meta. 

You  will  notice  that  there  is  a  key  labeled  "Kseape"  and  a  key  labeled  "Alt".  The  Allmodc  character  is  the 
one  labeled  “Alt".  "Kseape"  has  other  functions  entirely:  it  is  handled  by  ITS  and  has  nothing  to  do  with 
l-MACS.  While  we  arc  talking  about  keys  handled  by  ITS,  on  Meta  keyboards  the  way  to  interrupt  a 
program  is  CALI.,  rather  than  Control-/,  and  entering  communicate  mode  uses  die  HACK-NLXl'kcy  rather 
than  Control-..  CA1 .1.  echoes  as  t/.  but  if  you  type  C  /  it  is  just  an  ordinary  character  which  happens  to  be 
an  LM  ACS  commend  to  return  to  the  superior.  Similarly,  BACK-NLXT  echoes  as  t_  but  if  you  type  t_  it  is 
just  an  l-MACS  command  which  happens  not  to  be  defined. 

The  key  labeled  "  l  op"  is  an  exua  shift  key.  It  is  used  to  produce  the  peculiar  "SAIL"  graphics  characters 
which  appear  on  the  same  keys  ns  the  letters,  'ihc  "Shift"  key  gets  you  upper-ease  letters,  but  "Top"  gels  you 
the  SAIL  characters.  As  l-MACS  commands,  these  characters  arc  normally  self-inserting,  like  all  printing 
characters.  Hut  once  inserted,  SAIL  characters  arc  really  the  same  as  ASCII  control  characters,  and  since 
characters  in  files  arc  just  7  bits  there  is  no  way  to  tell  them  apart.  l-MACS  can  display  them  either  as  ASCII 
control  characters,  using  an  uparrow  or  caret  to  indicate  them,  or  it  can  display  them  as  SAIL  characters, 
whichever  you  like.  'Ihc  character  Control-Alpha  (Alpha  is  a  SAIL  character)  toggles  the  choice.  You  can 
only  type  this  command  on  a  terminal  with  a  Top  key,  but  since  only  such  terminals  can  display  SAIL 
characters  anyway  this  is  no  loss. 

One  other  thing  you  can  do  with  the  Top  key  is  type  the  I  lelp  character,  which  is  Top-1 1  on  these 
keyboards.  BACK-NKXT I  I  also  works,  though. 

Lor  inserting  an  Altmode,  on  an  ideal  keyboard  you  can  type  C-M-Altmode.  C-Alttnode  is  a  synonym  for 
C-M-CTR  I  out). 

'Ihc  "bit  prefix"  characters  that  you  must  use  on  other  terminals  arc  also  available  on  terminals  with  Meta 
keys,  in  ease  you  find  them  more  convenient  or  get  into  habits  on  those  other  terminals. 
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To  type  numeric  arguments  on  these  keyboards,  type  the  digits  or  minus  sign  while  holding  down  either 
Control  or  Meta. 

1.2.  Keyboards  with  an  "Edit"  key 

Keyboards  with  Kidit  keys  probably  belong  to  Datamedia  orTclcrav  terminals.  ’Ibc  1-dit  and  Control  keys 
arc  a  pair  of  shill  keys.  Use  the  Control  key  to  type  Control  characters  and  the  I-dit  key  to  type  Meta 
characters,  'lluis,  the  9-bit  KMACS  character  C-M-Q  is  typed  by  striking  the  "Q"  key  while  holding  down 
"Kdit"  and  "Control". 

While  the  Kdit  key  is  a  true  independent  bit  which  can  be  combined  with  anything  else  you  can  type,  the 
Control  key  really  means  "ASCII  control”,  Thus.  the  only  Control  characters  you  can  type  arc  those  which 
exist  in  ASCII.  'Ibis  includes  C-A  through  C-Y,  C-J.  C-<?{\  C-\,  and  C-".  C-/. and  C-_  car:  be  typed  on  the 
terminal  but  they  are  intercepted  by  the  operating  system  and  therefore  unavailable  as  KMACS  commands. 
C-(  is  not  available  because  its  spot  in  ASCII  is  pre-empted  by  Altmode.  'I'hc  corresponding  Meta  commands 
arc  also  hard  to  type.  If  you  can’t  type  C-;  directly,  then  you  also  can't  type  C-M-;  directly. 

Though  you  can’t  type  C*;  directly,  you  can  use  the  bit  prefix  character  C-~  and  type  C-~  ;.  Similarly, 
while  >ou  can’t  type  C-M-;.  you  can  use  the  Control-Meta  prefi-  C-C  and  type  C’-C  :.  Because  C-'1  is  itself 
awkward,  we  have  designed  the  I  {MACS  command  set  so  that  the  hard-lo-typc  Control  (non-Meta)  characters 
are  rarely  needed. 

In  order  to  type  the  I  lelp  character  you  must  actually  type  two  characters.  C-_  and  1 1.  C-_  is  an  escape 
character  for  I  I  S  itself,  and  C-_  followed  by  1 1  causes  i  I  S  to  give  tlic  Help  character  as  input  to  KMACS. 

To  type  numeric  arguments,  it  is  best  to  type  the  digits  or  minus  sign  while  holding  down  the  Kdil  key. 


1.3.  ASCII  Keyboards 

An  ASCII  keyboard  allows  you  to  type  in  one  keysliokc  only  the  command  characters  with  equivalents  in 
ASCII.  No  Meta  characters  are  possible,  and  not  all  Control  characters  arc  possible  either.  ’I’hc  Control 
characters  which  you  can  type  directly  are  C-A  through  C’-Y,  C-j,  C -Qi\  C-\.  and  C-~.  C-Zand  C-_  can  be 
typed  on  the  tcnnin.il  but  they  arc  intercepted  by  the  operating  system  and  iherefoie  unavailable  as  I  {MACS 
commands.  C-{  is  not  available  because  its  spot  in  ASCII  is  pre-empted  by  AUmodc. 

'Ihosc  characters  which  you  can’t  type  directly  can  be  typed  as  two  character  sequences  using  the  bit  prefix 
characters  Altmodc,  C-C  and  C-~.  Allmodc  turns  on  the  Meta  bit  of  die  character  that  follows  it.  ’ITnis,  M-A 
can  be  typed  as  Allmodc  A,  and  C-M-A  as  Alunodc  C-A.  Altmodc  can  be  used  to  get  almost  all  of  the 
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characters  that  can't  be  typed  directly.  C-C  can  be  used  to  type  any  Control-Mcta  character,  including  a  few 
that  Altmode  can't  be  used  for  because  the  corresponding  non-Meta  character  isn’t  on  the  keyboard.  ’lints, 
while  you  can’t  type  C-M-;  as  Altmodc  Control-;,  since  there  is  no  Control-;  in  ASCII,  you  can  type  C-M-;  as 
C-C  ;.  Hie  Control  (non-Meta)  characters  which  can’t  be  typed  directly  require  the  use  of  C-~.  as  in  C-~  <  to 
get  the  effect  of  C-<.  because  C-~  by  itself  is  hard  to  type,  the  EMACS  command  set  is  arranged  so  that  most 
of  these  non-ASCII  Control  characters  arc  not  very  important  Usually  they  have  synonyms  which  arc  easier 
to  type.  In  fact,  in  this  manual  only  the  casicr-to-type  forms  arc  usually  mentioned. 

In  order  to  type  the  Help  character  you  must  actually  type  two  diameters.  C-_  and  1!.  C-_  is  an  escape 
character  for  ITS  itself,  and  C-_  followed  by  H  causes  I  I  S  to  give  the  I  Iclp  character  as  input  to  EMACS. 

On  ASCII  keyboards,  you  can  type  a  numeric  argument  by  typing  an  Altmodc  followed  by  die  minus  sign 
and/or  digits.  Then  comes  the  command  for  which  the  argument  is  intended.  For  example,  type  Altmodc  5 
C-N  to  nunc  down  live  lines.  If  the  command  is  a  Meta  command,  it  must  have  an  Altmodc  of  its  own.  as  in 
Altmodc  5  Altmodc  F  to  move  forward  five  words. 

Note  to  cusioini/crs:  this  effect  requires  redefining  the  Meta-digit  commands,  since  the  Altmodc  and  the 
first  digit  amount  to  a  Meta-digit  character.  'Hie  new  definition  i.>  Autoarg.  and  the  redefinition  is  done 
by  the  default  init  file. 

If  you  use  numeric  arguments  very  often,  and  even  typing  the  Altmodc  is  painful,  you  might  enjoy  using 
Autoarg  mode,  in  which  you  can  specify  a  numeric  argument  by  just  typing  the  digits.  See  section  4 
(Arguments),  page  17.  for  details. 

1.4.  Uppcr-case-only  Terminals 

On  terminals  lacking  the  ability  to  display  or  enter  lower  ease  characters,  a  special  input  and  output 
ease-flagging  convention  has  been  defined  for  editing  files  which  contain  lower  ease  characters. 

The  customary  escape  convention  is  that  a  slash. prefixes  any  upper  ease  letter;  all  unprefixed  letters  arc 
lower  ease  (see  below  for  the  "lower  case  punctuation  characters"),  'lliis  convention  is  chosen  because  lower 
ease  is  usually  more  frequent  in  files  containing  any  lower  ease  at  all.  Upper  ease  letters  arc  displayed  with  a 
slash  ("/")  in  front.  Typing  a  slash  followed  by  a  letter  is  a  good  way  to  insert  an  upper  case  letter.  Typing  a 
letter  without  a  slash  inserts  a  lowercase  letter.  For  the  most  part,  die  buffer  will  appear  as  if  the  slashes  had 
simply  been  inserted  (type  /A  and  it  inserts  an  upper  ease  A,  which  displays  as  /A),  but  cursor-motion 
commands  will  reveal  that  the  slash  and  the  A  arc  really  just  one  character.  Another  way  to  insert  an 
upper-case  letter  Is  to  quote  it  with  C-Q. 

Note  that  this  escape  convention  applies  only  to  display  of  the  buffer  and  insertion  in  the  buffer.  It  docs 
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not  apply  to  arguments  of  commands  (it  is  hardly  ever  useful  for  them,  sine**  ease  is  ignored  in  command 
names  and  most  commands'  arguments).  Case  conversion  is  perfonned  when  you  type  commands  into  the 
minibuflci.  but  not  when  the  commands  arc  actually  executed.  . 

'Hie  ASCII  character  set  includes  several  punctuation  characters  whose  codes  fall  in  the  lowercase  range 
and  which  cannot  be  typed  or  displayed  on  terminals  that  cannot  handle  lower  ease  letters.  Incse  arc  the 
curly  braces  ("{"  and  “}").  the  vertical  bar  ("|").  the  tilde  and  the  accent  grave.  'ITicir  upper  case 
equivalents  are.  respectively,  the  square  brackets  ("[“  and  ”]”).  the  backslash  ("V).  the  caret  ("■'“),  and  the 
aisign  (”(S  ”).  For  these  punctuation  characters.  KMACS  uses  the  opposite  convention  of  that  used  for  letters: 
the  ordinary,  uppercase  punctuations  display  as  and  arc  entered  .is  themselves,  while  the  lowercase  forms  arc 
prefixed  by  slashes.  Ihis  is  because  llic  "lower  ease"  punctuations  arc  much  less  frequently  used.  So.  to 
insert  an  aicC-m  grave,  type 

When  the  slash  escape  convention  is  in  effect,  a  slash  is  displayed  and  entered  as  two  slashes. 

'Iliis  slash-escape  convention  is  not  normally  in  effect.  To  tun:  it  on.  the  TI-CO  command  (minus 
one  dollar  sign,  not  Allmodc!)  must  lie  executed,  ’llte  easiest  way  to  do  this  is  to  use  the  minibuffen 
Altmode  Alimodc  -1$  Altmnde  Altmode.  To  turn  off  the  escape  convention  (for  editing  file  of  all  upper 
ease),  the  command  is  0$  (/cro  dollar  sign),  or  Altmodc  Altmnde  OS  Allmodc  Alinmdc.  If  you  use  such  a  bad 
terminal  frequently,  you  can  define  yourself  an  l-MACS  exteasion.  a  command  to  turn  slash-escape  on  and 
off. 

The  lower  ease  editing  feature  i<  actually  more  flexible  than  described  here.  Refer  to  the  TLCO 
commands  FS  and  FS  CASF't.  using  M-X  TKCIXX'.  for  full  details. 


1.5.  The  SLOWLY  Package  for  Slow  Terminals 

Tlic  SI  OW1.Y  library  is  intended  as  an  aid  for  people  vising  display  terminals  at  slow  speeds.  It  provides 
means  of  limiting  redisplay  to  smaller  parts  of  the  screen,  and  for  turning  off  redisplay  for  a  time  while  you 
edit. 

To  uscSI.OWI.Y.do  M-X'  Load  1  .ibraryLSl  .OWI  ,Y<cr>  and  if  your  terminal  is  a  display  operating  at  I20C 
baud  oi  less  (or  if  its  speed  is  unknown)  SLOWLY  will  set  up  the  commands  described  here. 


Comments,  hugs,  and  suggestions  to  RWK(ft'MIT-MC 
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1.5.1.  Brief  Description 

SLOWLY  provides  an  alternate  version  of  the  incremental  searching  comands  on  C-S  and  C*R,  AR  lidit 
Quietly  on  OX  Q,  a  way  to  shrink  the  screen  at  cither  the  top  or  the  bottom  on  M-O,  and  more  flexibility  in 
where  miniouffers  get  displayed.  If  SLOWLY  is  loaded,  it  redefines  these  commands  only  if  the  terminal 
speed  is  1200  baud  or  less. 


L5.2.  SLOWLY  Commands 


The  commands  provided  are: 

M-0  (aR  Set  Screen  Si/.c) 

This  functioi.  reduces  the  amount  of  the  screen  used  foi  displaying  jour  text,  down  to  a 
few  lines  al  the  top  or  the  bottom.  If  called  without  an  aigumcnl,  it  will  use  the  same  si/.c 
as  last  time  (oi  .1  if  it  hasn't  been  called  before).  If  given  a  positive  argument,  that  is  taken 
to  he  the  number  of  lines  to  use  <u  the  top  of  the  screen.  If  given  a  negative  argument,  it  is 
taken  to  be  the  number  of  lines  at  the  bottom  of  the  screen.  If  given  an  argument  of  0,  it 
retm  ns  to  the  use  of  the  entire  screen.  The  section  of  the  screen  that  is  in  use  is  (Jcfaultly) 
delimitc  by  a  line  of  6  dashes.  This  command  sets  the  variable  Short  Display  Size. 

C-S  (~R  Slow  Display  1-Search) 

This  function  is  just  like  the  usual  incremental  search,  except  if  the  search  would  run  off 
the  sc  teen  and  cause  a  redisplay,  it  narrows  the  screen  to  use  only  a  few  lii^s  at  the  top  or 
bottom  of  the  screen  to  do  the  redisplay  in.  When  the  search  is  exited,  use  of  the  full 
screen  resumes.  The  si/.c  of  the  window  used  for  the  search  is  the  value  of  the  variable 
Slow  Search  Lines.  If  it  is  positive,  it  is  number  of  lines  at  top  of  screen;  if  negative,  it  is 
the  number  of  lines  at  bottom  of  screen.  The  default  is  1.  The  variable  Slow  Search 
Separator  contains  the  string  used  to  show  the  end  of  live  search  window.  By  default  it  is 
six  dashes.  See  section  10  (Search],  page  41. 

C-R  (AR  Slow  Reverse  Display  l-Scarch) 

This  searches  in  backwards  in  ihc  style  of  ~R  Slow  Display  1-Scrrch. 

C-XQQR  Kdit  Quietly) 

This  function  enters  a  recursive  cdii>0  level  with  redisplay  inhibited.  This  means  that 
your  commands  are  carried  out  but  the  screen  doc.;  not  change.  C-L  with  no  argument 
redisplays.  So  you  can  update  the  screen  when  you  want  to.  Two  C-I.'s  in  a  row  dear  the 
screen  and  redisplay.  C-L  with  an  argument  repositions  the  window,  as  usual  (See 
section  15  (C-l  .J,  page  71.).  To  exit  and  resume  continuous  redisplay,  use  C-M-C. 


1.5.3.  Minibuffers 

SLOWLY  pro*  ides  control  over  how  minibuffers  display  on  your  set  ecn.  The  variable  Minibuffer  Size 
specifics  how  many  lines  it  takes  up.  If  this  is  made  negative,  the  minibuffer  will  appear  at  the  bottom  of  the 
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screen,  instead  of  the  top.  Thus  one  mode  of  operation  which  some  people  like  is  to  use  AR  Set  Screen  Si/.c  to 
set  up  to  not  use  die  bottom  3  lines  of  the  screen,  and  set  Minibuffer  Si/.c  to  -3.  This  will  permanently  reserve 
3  lines  at  die  bottom  of  the  screen  for  the  minibuffer.  See  section  23  IMinibuflcr].  page  127. 

1'he  variable  Minibuffer  Separator  holds  the  string  used  to  separate  the  minibuffer  area  from  the  rest  of 
the  screen.  By  default,  this  is  six  dashes. 

SI.OWI.Y  installs  its  minibufferby  defining  the  variable  MM  &  Minibuffer. 


1.5.4.  SLOWLY  Options 

The  simplest  way  to  run  SLOWLY  is  to  simply  load  it.  and  use  die  default  key  assignments,  etc.  Here  is 
w  hat  SI  .0  Wl  .Y  sets  up  when  simply  loaded  normally,  provided  your  terminal  is  no  faster  than  1 200  baud. 

If  you  want  SLOWLY  rot  set  up  these  things  unless  your  terminal  is  running  at  300  baud  or  slower 
(ugh!),  set  the  variable  SLOV»  i.Y  Maximum  Speed  to  the  highest  speed  at  which  SI.OWI.Y  is  desired.  Put 
the  following  in  your  HMACS  init  file: 

300  M.VSL0WLY  Maximum  Speed* 

II  you  don't  like  the  command  assignments  set  up  by  SLOWLY,  you  can  override  them  by  defining  the 
variable  SLOWLY  Setup  I  look  before  loading  SLOWLY.  The  value  should  be  THCO  commands  to  define 
the  command  assignments  you  wish. 

SLOWLY  normally  uses  lines  of  six  dashes  to  separate  areas  of  the  screen.  You  can  tell  it  to  use  something 
else  instead.  Minibuffers  use  the  value  of  Minibuffer  Separator,  searches  use  the  value  of  Slow  Search 
Separator.  If  one  of  these  is  unspecified  (the  variable  does  not  exist),  the  value  of  Default  Separator  is  used. 
1  lie  separator  for  small  screen  mode  is  always  the  value  of  Default  Separator.  If  the  value  specified  is  the  null 
string,  a  blank  line  is  used.  If  the  value  specified  is  zero,  nothing  (not  even  a  blank  line)  is  used.  This  is  useful 
for  searches,  since  you  aren’t  going  to  be  doing  any  editing  in  the  search  window. 

Kven  though  SLOWLY  does  not  redefine  the  commands  on  a  fast  terminal,  you  might  wish  to  load  it  only 
on  slow  terminals  to  save  address  space  the  rest  of  the  time.  This  can  be  done  in  an  init  file  with 
fsospeed>-1200 : "g  m(m.ml.oad  Library*)SLOWLY*’ 
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Appendix  II 

Use  of  EMACS  from  Printing  Terminals 

While  KMACS  was  designed  to  be  used  from  a  display  terminal,  you  can  use  it  effectively  from  a  printing 
terminal.  You  cannot,  however,  learn  KMACS  using  one. 

All  KM  \CS  commands  have  the  same  editing  effect  from  a  printing  terminal  as  they  do  from  a  display. 
All  that  is  different  is  how  they  try  to  show  what  they  have  done.  KMACS  attempts  to  make  the  same 
commands  that  you  would  use  on  a  display  terminal  act  like  an  intciaclivc  line-editor.  It  docs  not  do  as  good 
a  job  as  editors  designed  originally  for  that  purpose,  but  it  succeeds  well  enough  to  keep  you  informed  of 
what  your  commands  .ire  accomplishing,  provided  you  know  what  they  arc  supposed  to  do  and  know  how 
they  would  look  on  a  display. 

The  usual  buffer  display  convention  for  KMACS  on  a  printing  terminal  is  that  the  part  of  the  current  line 
before  the  caisor  is  printed  out,  with  the  cursor  following  (at  the  right  position  in  the  line).  What  follows  the 
cursor  on  the  line  is  not  immediately  visible,  but  normally  you  will  have  a  pi  intout  of  the  original  contents  of 
the  line  a  little  ways  back  up  the  paper.  For  example,  if  the  current  line  contains  the  word  "FOOBAR",  and 
the  cursor  is  after  the  'TOO",  just  "l-OO"  would  appear  on  the  paper,  with  the  cursot  following  it.  Typing 
the  C-F  command  to  move  over  the  "B"  would  cause  "B"  to  be  printed,  so  that  you  would  now  see  "FOOB” 
with  the  cuisor  following  it.  All  forwaid-motion  commands  that  move  reasonably  shoit  distances  print  out 
what  they  move  over. 

Backward  motion  is  handled  in  a  complicated  way.  As  you  move  back,  the  terminal  backspaces  to  the 
correct  place.  When  you  stop  moving  back  anu  do  something  eisc,  a  linefeed  is  printed  liisl  thing  so  that  the 
printing  done  to  reflect  subsequent  commands  does  not  overwrite  the  text  you  moved  back  over  and  become 
garbled  by  it.  The  Ruboui  command  acts  like  backward  motion,  but  also  prints  a  sla.dr  over  the  character 
rubbed  out.  Other  backwards  deletion  commands  act  like  backward  motion;  they  do  not  print  slashes  (it 
would  be  an  improvement  if  they  did). 

One  command  is  different  on  a  printing  terminal:  C-l.,  which  normally  means  "clear  the  screen  and 
redisplay".  Willi  no  argument,  it  retypes  the  entire  current  line.  An  argument  tclis  it  to  retype  the  specified 
number  of  lines  around  the  current  line. 

Unfortunately,  KMACS  cannot  perfectly  attain  its  goal  of  making  the  text  printed  on  the  current  line 
reflect  the  current  line  in  the  buffer,  and  keeping  the  hori/.onta!  position  of  the  cursor  correct.  One  reason  is 
that  it  is  necessary  for  complicated  commands  to  echo,  but  echoing  them  screws  up  the  "display".  The  only 
solution  is  to  type  a  C-l.  whenever  you  have  trouble  following  things  in  your  mind,  'lire  need  to  keep  a 
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menial  model  of  the  text  being  edited  is,  of  course,  the  fundamental  defect  of  all  printing  terminal  editors. 

Note:  it  is  possible  to  make  a  specific  command  print  on  a  printing  terminal  in  whatever  way  is  desired,  if 
that  is  worth  while,  For  example,  Linefeed  knows  explicitly  how  to  display  itself,  since  die  general  TKCO 
redisplay  mechanism  isn't  able  to  handle  it.  Suggestions  for  how  individual  commands  can  display 
themselves  arc  welcome,  as  long  as  they  arc  algoridunic  rather  than  simply  of  the  form  "please  do  the  right 
thing". 


Glossary 
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Aborting  Aborting  a  recursive  editing  level  (q.v.)  means  canceling  the  command  which  invoked  the 

recursive  editing,  For  example,  if  you  abort  editing  a  message  to  be  sent,  the  message  is 
not  sent.  Aborting  is  done  with  the  command  C-J.  Sec  section  24.1  [Aborting],  page  129. 

Altinode  Altmodc  is  a  character,  labelled  Escape  on  some  keyboards.  It  is  the  bit  prefix  character 

(q.v.)  used  to  enter  Meta-characters  when  the  keyboard  docs  not  have  a  Meta  (q.v.)  key. 
Sec  section  2  [Characters],  page  9.  Also,  it  delimits  string  arguments  to  extended 
commands.  Sec  section  5  [Intended],  page  19. 

Balance  Parentheses 

EMACS  can  balance  parentheses  manually  or  automatically.  You  can  ask  to  move  from 
one  paicnlhcsis  to  the  matching  one.  See  section  20.6.1  [I  ists],  page  94.  When  you  insert  a 
close  parenthesis,  EM  ACS  can  show  the  matching  open.  See  section  20.4  [Matching], 
page  90. 

Bit  Prefix  Character 

A  bit  prefix  character  is  a  command  which  combines  with  the  next  character  typed  to  make 
one  character.  They  arc  used  for  effectively  typing  commands  which  the  keyboard  being 
used  is  not  able  to  send.  For  example,  to  use  a  Meta-character  when  there  is  no  Meta  key 
on  the  keyboard,  the  bit  prefix  character  Altmodc  (q.v.)  is  needed.  See  section  2  [Bit 
Prefix],  page  9. 

Buffer  The  buffer  is  the  basic  editing  unit;  one  buffer  corresponds  to  one  piece  of  text  being 

edited.  You  can  have  several  buffers,  but  at  any  time  you  arc  editing  only  one,  the 

"selected"  buffer,  though  two  can  be  visible  when  you  arc  using  two  windows.  See 

section  14  [Buffers],  page  67. 

C*  C  is  an  abbreviation  for  Control,  in  the  name  of  a  character.  See  section  2  [C-],  page  9. 

C-M-  C-M-  is  an  abbreviation  for  Control-Mcta,  in  the  name  of  a  character.  See  section  2 

[C-M-J,  page  9, 

Command  A  command  is  a  character  or  sequence  of  characters  which,  when  typed  by  the  user,  fully 
specifies  one  action  to  be  performed  by  HMACS.  For  example,  "X"  and  "Control-F"  and 
"Meta-X  Text  Mode<cr>"  arc  commands.  See  section  2  [Command],  page  9.  Sometimes 
die  first  character  of  a  multi-character  command  is  also  considered  a  command:  M-X  Text 
Modc<cr>  is  a  command  (an  extended  command),  and  M-X  is  also  a  command  (a 
command  to  scad  a  function  name  and  invoke  the  function).  See  section  5  [Extended], 
page  19. 

Completion  Completion  is  what  EM  ACS  docs  when  it  automatically  fills  out  the  beginning  of  an 
extended  command  name  into  the  full  name,  or  as  much  of  it  as  can  be  deduced  for 
certain.  Completion  occurs  when  Altmode,  Space  or  Return  is  typed.  Sec  section  5 
[Completion],  page  19. 

Connected  A  character  command  in  EM  ACS  works  by  calling  a  function  which  it  is  "connected"  to. 

Customization  often  involves  connecting  a  character  to  a  different  function.  See  "Dispatch 
table".  See  section  2  [Connected],  page  9. 
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Continuation  Line 

When  a  line  of  text  is  longer  than  the  width  of  the  screen,  it  is  displayed  on  more  than  one 
line  of  screen.  Wc  say  that  the  line  is  continued,  and  that  all  screen  lines  used  but  the  first 
arc  called  continuation  lines.  See  section  1  [Continuation],  page  5. 

Control  Control  is  the  name  of  a  bit  which  each  command  character  docs  or  docs  not  contain.  A 

character’s  name  includes  the  word  Control  if  the  Control  bit  is  part  of  that  character. 
Ideally,  this  means  that  the  character  is  typed  using  the  Control  key:  Control-A  is  typed  by 
typing  "A"  while  holding  dowm  Control.  On  most  keyboards  the  Control  key  works  in 
only  some  cases;  the  rest  of  the  time,  a  bit  prefix  character  (q.v.)  must  be  used.  Sec 
section  2  [Control],  page  9. 

Control-Character 

A  Control  character  is  a  character  which  includes  the  Control  bit. 

Control-X  Command 

A  Control-X  command  is  a  two-character  command  whose  first  character  is  the  prefix 
character  Control-X.  See  section  2  (Control-X  Command],  page  9. 

<cr>  <cr>  stands  for  the  carriage  return  character,  in  contexts  where  the  word  "Return"  might 

be  confusing.  See  section  2  [<cr>],  page  9. 

CIU.F  CRI.K  stands  for  the  sequence  of  two  characters,  carriage  return  followed  by  linefeed, 

which  is  used  to  separate  lines  in  files  and  text  being  edited  in  KMACS.  Sec  section  2 
[CRI.K],  page  9. 

Cursor  ITic  cursor  is  die  object  on  die  screen  which  indicates  the  position  called  "point"  (q.v.)  at 

which  insertion  and  deletion  takes  place.  The  cursor  is  part  of  the  terminal,  and  often 
blinks  or  underlines  the  character  where  it  is  located.  See  section  3  [Cursor],  page  13. 

Cusiomi/ation  Customization  is  making  minor  changes  in  the  way  KMACS  works.  It  is  often  done  by 
setting  variables  (See  section  22.3  [Variables],  page  114.)  or  by  reconnecting  commands 
(See  section  5.2  [Reconnect],  page  21.). 

DKFUN  A  DIT’UN  is  a  list  at  the  lop  level  of  list  structure  in  a  Lisp  program.  It  is  so  named 

because  most  such  lists  arc  calls  to  the  Lisp  function  DKI-’UN.  See  section  20.6.2  []. 
page  95. 

Delete  This  is  the  label  used  on  some  terminals  for  the  Rubout  character. 

Deletion  Deletion  means  erasing  text  without  saving  it.  KMACS  deletes  text  only  when  it  is 

expected  not  to  be  worth  saving  (all  whitespace,  or  only  one  character).  'ITic  alternative  is 
"killing"  (q.v ).  Sec  section  9.1  [Deletion],  page  35. 

Dispatch  Table  The  dispatch  table  is  what  records  the  connections  (q.v.)  from  command  characters  to 
functions.  Hunk  of  a  telephone  switchboard  connecting  incoming  fines  (commands)  to 
telephones  (functions).  A  standard  KMACS  lias  one  set  of  connections:  a  customized 
KMACS  may  have  different  connections.  See  section  5.2 1  Dispatch  Table],  page  21. 

Kcho  Area  The  echo  area  is  the  bottom  thicc  lines  of  the  screen,  used  for  echoing  the  arguments  to 
commands,  for  asking  questions,  and  printing  brief  messages.  See  section  1  |Kcho  Area], 
page  5. 
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Echoing  Helloing  is  acknowledging  liic  receipt  of  commands  by  displaying  them  (in  the  echo  area). 

Most  programs  other  than  KM  ACS  echo  all  their  commands.  KM  ACS  never  echoes 
single-character  commands;  longer  commands  echo  only  if  you  pause  while  typing  them. 

Escape  Escape  is  the  label  used  on  some  terminals  for  the  Altmodc  character. 

Exiting  Exiting  EMACS  means  returning  to  KMACS's  superior,  normally  l-IACTRN.  See 

section  6.3  [Exiting],  page  26.  Exiting  a  recur. ivc  editing  level  (q.v.)  means  allowing  the 
command  which  invoked  the  recursive  editing  to  complete  normally.  For  example,  if  you 
arc  editing  a  message  to  be  sent,  and  yon  exit,  the  message  is  sent. 

Extended  Command 

An  extended  command  is  a  command  which  consists  of  the  character  Meta-X  followed  by 
the  command  name  (really,  the  name  of  a  function  (q.v.)).  An  extended  command 
requires  several  chat  actors  of  input,  but  its  name  is  made  up  of  English  words,  so  it  is  easy 
to  remember.  See  section  5  [Extended],  page  19. 

Extension  Extension  means  making  changes  to  I -MACS  which  go  beyond  the  bounds  of  mere 

customization.  If  customization  is  moving  the  furniture  around  in  a  room,  extension  is 
building  new- furniture.  Seethe  file  INI:0;C’ONV  >. 

Hilling  lulling  text  means  moving  text  from  line  to  line  so  that  .:M  the  lines  are  approximately  the 

same  length.  See  section  11. -I  | Filling],  page  47. 

Function  A  function  is  a  named  subroutine  of  EMACS.  When  you  type  a  command.  EMACS 

executes  a  function  which  corresponds  to  the  command,  and  the  function  docs  the  work. 
Short  commands  ire  connected  to  functions  through  the  dispatch  table  (q.v.).  Extended 
commands  contair  the  n;  me  of  the  function  to  be  called;  this  allows  you  in  call  any 
function.  See  section  5  [Extended],  page  19. 

Grinding  Grinding  means  reformatting  a  program  so  that  it  is  indented  according  to  its  structure. 

See  section  20.7  [Grinding],  page  96. 

Help  You  can  type  the  Help  character  at  any  time  to  ask  what  options  you  have,  or  to  ask  what 

any  command  docs.  See  section  7  [1  lelp],  page  29. 

I  lomc  Directory  Your  home  directory  is  the  one  on  which  your  mail  and  your  ink  files  arc  stored. 

INFO  INFO  is  the  subsystem  for  perusing  tree-structured  documentation  flics.  The 

documentation  in  INFO  includes  a  version  of  the  EMACS  manual. 

fi'S  ITS  is  the  Incompatible  Timesharing  System  written  at  the  MIT  Arlifn.i..‘  Intelligence  l.ab. 

EMACS  was  first  developed  on  this  system.  Just  what  it  is  incompatible  with  lias  changed 
from  year  to  year. 

Kill  Ring  The  kiil  ring  is  where  killed  text  is  saved.  It  holds  the  List  nine  or  so  blocks  of  killed  text. 

It  is  called  a  ring  because  ym:  can  bring  any  of  die  saved  blocks  to  lire  front  by  rotating  ll)C 
ring.  See  section  9.1  (Kill  ring],  page  35. 

Killing  means  erasing  text  and  saving  it  inside  EMACS  to  be  recovered  later  if  desired. 
Most  I iMACS  commands  to  erase  text  do  killing,  as  opposed  to  deletion  (q.v.).  See 
section  9.1  [Killing],  page  35. 
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I -1st  A  list  is,  approximately,  a  text  string  beginning  with  an  open  parenthesis  and  ending  with 

the  matching  close  parenthesis.  See  section  20.6.1  [Lists),  page  94.  Actually  there  arc  a  few 
complications  to  the  syntax,  which  is  controlled  by  the  syntax  table  (See  section  22.4 
[Syntax),  page  115.). 

M-  M-  in  the  name  of  a  character  is  an  abbreviation  for  Meta. 

M-X  M-X  is  the  character  which  begins  an  extended  command  (q.v.).  Kxtended  commands 

have  come  to  be  known  ahso  as  "M-X  commands",  and  an  individual  extended  command 
is  often  referred  to  as  ”M  X  utch-and  such".  See  section  5  [M-X],  page  19. 

Major  Mode  Ihc  major  modes  arc  a  mutually  exclusive  set  of  options  which  configure  KMACS  for 
editing  a  certain  sort  of  text.  Ideally,  each  programming  language  lias  its  own  major  mode. 
Sec  section  20  [Major  Mode],  page  87. 

Mark  Ihc  mark  points,  invisibly,  to  a  position  in  the  text.  Many  commands  operate  on  the  text 

between  point  and  the  mark  (known  as  "the  region",  q.v.).  Sec  section  8  [Mark],  page  31. 

Meta  Meta  refers  to  the  Meta  key.  A  character's  name  includes  the  word  Meta  if  the  Meta  key 

must  be  held  down  in  order  to  type  the  character.  If  there  is  no  Meta  key,  then  the 
Altmodc  character  is  used  as  a  prefix  instead.  See  section  2  [MetaJ,  page  9. 

Meta  Character  A  Meta  diameter  is  one  whose  character  code  includes  the  Meta  bit.  These  characters  can 
be  typed  only  by  means  of  a  Meta  key  or  by  means  of  the  Meti/cr  command  (q.v.). 

Metizer  Ihc  mctiz.cr  is  another  term  for  the  bit  prefix  character  for  the  Meta  hit;  namely,  Altmodc 

(q.v.). 

Minibuffer  Hie  minibuffer  is  a  facility  for  editing  and  then  executing  a  TKCO  program.  See 
section  23  [Minibufferj.  page  127. 

Minor  mode  A  minor  mode  is  an  optional  feature  of  KMACS  which  can  he  switched  on  or  off 
independently  of  all  other  features,  liach  minor  mode  is  both  the  name  of  an  option  (q.v.) 
and  the  name  of  an  extended  command  to  set  the  option.  See  section  22.1  [Minor  Mode], 
page  111. 

MM-command  This  is  an  obsolete  synonym  for  "extended  command". 

Mode  line  The  mode  line  is  a  line  just  above  the  echo  area  (q.v.),  used  for  status  information.  See 
section  1.1  [Mode  Line],  page  6. 

Narrowing  Narrowing  means  limiting  editing  to  only  a  part  of  the  text  in  the  buffer.  Text  outside  that 
part  is  inaccessible  to  the  user  until  the  boundaries  arc  widened  again,  but  it  is  still  there, 
and  saving  the  file  saves  it  all.  See  section  17  [Narrowing],  page  77. 

Numeric  Argument 

A  numeric  argument  is  a  number  specified  before  a  command  to  change  the  effect  of  the 
command.  Often  the  numeric  aigumcnt  serves  as  a  repeal  count.  See  section  4  [Numeric 
Argument],  page  17. 

Option  An  option  is  a  vat  iable  which  ex>sts  to  he  set  by  the  usei  to  change  the  behavior  of  KM  AC'S 

commands,  ’litis  is  an  impoitnnt  method  of  customization.  See  section  22.3  [Options!, 
page  1 14. 
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Parse  Wc  say  that  HMACS  parses  words  or  expressions  in  the  text  being  edited.  Really,  all  it 

knows  how  to  do  is  find  die  odicr  end  of  a  word  or  expression.  C:c  section  22.4  [Syntax], 
page  115. 

Point  Point  is  the  place  in  the  buffer  at  which  insertion  and  deletion  occur.  Point  is  considered  to 

be  between  to  characters,  not  at  one  character.  The  tcnninal's  cursor  (q.v.)  indicates  the 
location  of  point.  See  section  3  [Point],  page  13. 

Prefix  Character  A  prefix  character  is  a  command  whose  sole  fit  notion  is  to  introduce  a  set  of 
multi-character  commands.  Control-X  (q.v.)  is  a  prefix  character.  Hie  bit  prefix 
characters  (q.v.)  arc  other  examples. 

Prompt  A  prompt  is  text  printed  in  the  echo  area  to  ask  the  user  for  input.  Printing  a  prompt  is 

called  "prompting".  HMACS  can  prompt  when  a  command  requires  an  argument,  or 
when  only  part  of  a  command  has  been  typed.  However,  the  prompt  will  not  appear 
unless  you  pause  in  your  typing.  See  section  5  [Prompt],  page  19. 

Q- Registers  Q- registers  are  internal  THCO  variables  which  can  be  used  by  HMACS  or  by  the  user  to 
store  text  or  numbers. 

Quitting  Quilting  means  interrupting  a  command  which  is  partially  typed  in  or  already  executing.  It 

is  done  with  Control-G.  See  section  24.1  [Quitting],  page  129. 

Quoting  Quoting  means  depriving  a  character  of  its  usual  special  significance.  It  is  usually  done 

with  Control-Q.  What  constitutes  special  significance  depends  on  the  context  and  on 
convention.  For  example,  an  "ordinary"  character  as  an  HMACS  command  inserts  itself; 
so  you  can  insert  any  other  character,  such  as  Ruboul,  by  quoting  it  as  in  Control-Q 
Rubout.  Not  all  contexts  allow  quoting. 

Recursive  Hditing  Level 

A  recursive  editing  level  is  a  suite  in  which  par*  of  the  execution  of  a  command  involves 
asking  the  user  to  edit  some  text,  ’litis  text  may  or  may  not  be  the  same  as  the  text  to  which 
the  command  was  applied.  I  lie  mode  line  indicates  recursive  editing  levels  with  square 
brackets  ("["  and  "]").  See  section  6.2  [Recursive  Hditing  Level],  page  26. 

Redisplay  Redisplay  is  the  process  of  correcting  the  image  on  the  screen  to  correspond  to  changes 

dial  have  been  made  in  the  text  being  edited.  See  section  1  (Redisplay],  page  5. 

Region  Hie  region  is  the  text  between  point  (q.v.)  and  the  mark  (q.v.).  'Hie  tcnninal's  cursor 

indicates  the  location  of  point,  but  the  mark  is  invisible.  Many  commands  operate  on  the 
text  of  the  region.  See  section  8  [Region],  page  31. 

Return  Return  is  the  carriage  return  character,  used  as  input  to  HMACS.  Return  is  used  as  a 

command  in  itself  to  insert  a  line  separator,  it  also  terminates  arguments  for  most 
commands.  See  section  2  [Return],  page  9. 

Rubout  Ruboul  is  a  character,  sometimes  labelled  "Delete".  It  is  used  as  a  command  to  delete  one 

character  of  text.  It  also  deletes  one  character  when  an  HMACS  command  is  reading  an 
argument. 

S  expression  An  s-expression  is  the  basic  syntactic  unit  of  Lisp:  either  a  list,  or  a  symbol  containing  no 
parentheses  (actually,  there  arc  a  few  exceptions  to  the  rule,  based  on  die  syntax  of  Lisp). 
See  section  20.6.1  [S-expressionsj,  page  94. 
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Selecting  Selecting  a  buffer  (q.v.)  means  making  editing  commands  apply  to  that  buffer  as  opposed 

to  any  other.  At  ail  times  one  buffer  is  sclctcd  and  editing  lakes  place  in  dial  buffer.  See 
section  14  [Select],  page  67. 

Self-documentation 

Self-documentation  is  the  feature  of  KM  ACS  which  can  tell  you  what  any  command  docs, 
or  give  you  a  list  of  all  commands  related  to  a  topic  you  specify.  You  ask  for 
self-documentation  with  the  Help  character.  Sec  section  7  [Self-documentation],  page  29. 

String  Argument  A  string  argument  is  an  argument  which  follows  the  command  name  in  an  extended 
command.  In  "M-X  Apropos$word<cr>",  "Word"  is  a  string  argument  to  the  Apropos 
command.  See  section  5  [String  Arguments],  page  19. 

Subsystem  A  subsystem  of  KM  ACS  is  an  KM  ACS  command  which,  itself,  reads  commands  and 
displays  the  results.  Hxamplcs  are  INFO,  which  is  for  perusing  documentation;  DlltKi). 
which  is  for  editing  directories;  RMAIl.  and  BAIlYL  which  arc  for  reading  and  editing 
mail.  The  word  "subsystem"  implies  dial  it  offers  many  independent  commands  which 
can  be  used  freely.  If  an  KMACS  function  asks  specific  questions,  we  do  not  call  it  a 
subsystem. 

Usually  the  subsystem  continues  in  operation  until  a  specific  command  to  exit  (usually 
"Q")  is  typed.  The  commands  for  a  subsystem  do  not  usually  resembse  ordinary  KM  ACS 
commands,  since  editing  text  is  not  their  purpose.  Hie  Help  character  should  elicit  the 
subsystem's  documentation.  See  section  6.1  [Subsystems],  page  25. 

Syntax  Table  The  syntax  table  tells  KMACS  which  characters  arc  part  of  a  word,  which  characters 
balance  each  other  like  parentheses,  etc.  See  section  22.4  {Syntax],  page  1 15. 

Tailoring  I'his  is  a  synonym  for  customization  (q.v.). 

TKCO  Search  String 

A  TKCO  search  siring  is  a  sort  of  pattern  used  by  the  TKCO  search  command,  and  also  by 
various  KMACS  commands  which  use  the  TKCO  search  command.  See  section  19.3 
[TKCO  search  string],  page  85. 

Tip  Level  Top  level  is  the  normal  state  of  KMACS,  in  which  you  arc  editing  the  text  of  the  file  you 
have  visited.  You  arc  at  top  level  whenever  you  arc  not  in  a  recursive  editing  level  or  a 
subsystem  (q.v.). 

Twcncx  Twencx  is  the  operating  system  which  DKC  likes  to  call  ”’fOI,S-20".  However,  a  person 

should  not  be  forced  to  call  a  system  "tops"  unless  he  really  thinks  so.  Conic  now.  DKC. 
don't  you  think  people  will  pr.iise  your  products  voluntarily?  The  name  "Twcncx"  is  also 
more  appropriate  because  Twencx  was  developed  from  die  Tcncx  system,  and  has  no 
relationship  to  "TOPS- 10”.  What's  more,  it’s  very  euphonious. 

Typeout  Typeout  is  a  message,  printed  ••  an  KMACS  command,  which  ovcrwiilcs  the  area 

normally  used  for  displaying  the  text  being  edited,  but  which  docs  not  become  part  of  the 
text.  Typeout  is  used  for  messages  which  might  be  too  long  to  fit  in  the  echo  area  (q.v.). 
Sec  section  I  (Typeout],  page  5. 

Undo  Undo  is  a  command  which  undoes  the  effect  on  the  buffer  of  a  previous  command.  Only 

some  commands  arc  undoable  and  only  the  most  recent  undoablc  command  can  be 
undone.  See  section  24.3  (Undo],  page  132. 
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Un-killing  Un-killing  means  reinserting  text  previously  killed.  It  can  be  used  to  undo  a  mistaken  kill, 
or  for  copying  or  moving  text.  See  section  9.2  (Un-killing],  page  37. 

User  Name  Your  user  name  is  the  name  you  use  to  log  in.  It  identifies  you  as  opposed  to  all  the  other 
users.  It  may  he  the  same  as  your  home  directory’s  name. 

Variable  A  variable  is  a  name  with  which  KMACS  associates  a  value,  which  can  be  a  number  or  a 

string.  See  section  22.3  [Variables],  page  1 14.  Some  variables  ("options")  arc  intended  to 
be  used  or  set  by  the  user;  others  arc  for  purely  internal  purposes. 

Virtual  Boundaries 

'Hie  virtual  boundaries  delimit  the  accessible  part  of  the  buffer,  when  narrowing  (q.v.)  is  in 
effect.  Sec  section  17  (Virtual  Boundaries],  page  77. 

Visiting  Visiting  a  file  means  loading  its  contents  into  a  buffer  (q.v.)  where  they  can  be  edited.  See 

section  13.1  (Visiting],  page  55. 

Wall  Chart  The  wall  chart  is  a  very  brief  KM  ACS  reference  sheet  giving  one  line  of  information  about 
each  short  command.  A  copy  of  the  wall  chart  appears  in  this  manual  Whitespace 
Whitespace  is  any  run  of  consecutive  formatting  characters  (space,  tab,  carriage  return, 
linefeed,  and  backspace). 

Widening  Widening,  is  the  operation  which  undoes  narrowing  (q.v.).  See  section  17  [Widening], 

page  77. 

Window  A  window  is  a  region  of  the  screen  in  which  text  being  edited  is  displayed.  KM  ACS  can 

support  two  windows.  See  section  16  (Windows],  page  73.  "The  window"  also  mca.is  the 
position  in  the  buffer  which  is  at  the  top  of  the  screen.  See  section  15  [llie  Window], 
page  71. 

Working  Directory 

This  is  the  directory  which  you  have  told  the  system  you  wish  to  operate  on  primarily  at  the 
moment.  Often  this  will  be  the  same  as  your  home  directory  (q.v.).  It  is  specified  with  the 
DDT  command  :CWI)  <dircctory>. 

~R  The  string  "~R"  is  the  beginning  of  many  function  names.  See  section  5.2  (~R],  page  21. 

-R  mode  ~R  mode  is  the  real  time  editing  mode  ofTKCO.  KM  ACS  always  operates  in  this  mode. 


. . .  . .  . 
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Command  Index 


Command  Index 


•  his  index  contains  brief  descriptions  with  cross  references  for  all  commands,  grouped  by  topic.  Within 
each  topic,  they  arc  in  alphabetical  order.  Our  version  of  alphabetical  order  places  non-control  non-meta 
characters  first,  then  control  characters,  then  meta  characters,  then  control-metn  characters.  Control-X  comes 


Prefix  Cliantclers 


Altmode  (*K  Prefix  Meta) 

A.'lmode  is  a  hit  prefix  character  which  turns  on  the  Meta  bit  in  the  next  character.  Ihus, 
Altmodc  I-  is  equivalent  to  the  single  character  Meta-K  which  is  useful  if  your  keyboard 
has  no  Meta  key.  See  section  2  [Altmodc],  page  9. 

Control-*  (*R  Prefix  Control) 

Control-*  is  a  bit  prefix  character  which  turns  on  the  Control  bit  in  the  following  character. 
Thus.  Control-*  <  is  equivalent  to  the  single  character  ControK.  See  section  2  (Control-*), 
page  9. 

Control-C  (*R  Prefix  Control-Men) 

Control-C  is  a  bit  prefix  character  which  turns  on  die  Control  bit  and  the  Meta  bit  in  the 
following  character.  Thus.  Control-C ;  is  equivalent  to  the  single  character  Control-Mcta-; 
.  See  section  2  |Control-C],  page  9. 

Control-Q  (~R  Quoted  Insert) 

Control-Q  inserts  the  following  character.  Ibis  is  a  way  of  inserting  control  characters. 
See  section  3  [Control-Q],  page  13. 

Control-U  (*R  Universal  Argument) 

Control-U  is  a  prefix  for  numeric  arguments  which  works  the  same  on  all  terminals.  See 
section  4  [Control-U],  page  17. 

Control-X 

Control-X  is  a  prefix  character  which  begins  a  two-character  command.  Hach  combination 
of  Control-X  and  another  character  is  a  "Control-X  command".  Individual  Control-X 
commands  appear  in  this  index  .-iccording  to  their  uses. 

Meta-X  (*R  Intended  Command) 

Meta-X  is  a  prefix  character  which  introduces  an  extended  command  name.  Sec  section  5 
[Meta-Xj.  page  19. 

Control-Mcta-X  (*R  Instant  Intended  Command) 

Conlrol-Mcia-X  is  another  way  of  invoking  an  extended  command.  Instead  of  putting  the 
arguments  in  (lie  same  line  as  die  command  name,  the  command  reads  llic  arguments 
itself.  See  section  5  [Control-Mcta-XJ,  page  19. 

Control-digits,  Meta-digits,  Control-Mcta-digits 
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These  all  specify  a  numeric  argument  foi  the  next  command.  See  section  4  {Arguments], 
page  17. 

Control-Minus.  Meta-Minus,  Control-Mcta-Minus 

'lltesc  all  begin  a  negative  numeric  argument  for  the  next  command.  See  section  4 
{Arguments],  page  17. 


Simple  Cursor  Motion 

Control- A  ('R  Beginning  of  Line,  built-in  function) 

Coniroi-A  moves  to  the  beginning  of  the  line.  See  section  3  {Control-A],  page  13. 

Control-B  (“R  Backward  Character,  built-in  function) 

Conirol-R  moves  backward  one  character.  See  section  3  {Control-B],  page  13. 

Control-K  f"R  l-nd  of  Line,  built-in  function) 

Control-H  moves  to  the  end  of  die  line.  See  section  3  {Control-!-],  page  13. 

Control*!*  CK  forward  Character,  built-in  function) 

Control-!-'  moves  forward  one  character.  Sec  section  3  ]Control  F],  page  13. 

Control-1 1  CR  Backward  Character,  built-in  function) 

Control-1 1  moves  backward  one  character.  See  section  3  {Control-!  I],  page  13. 

Control-N  ("R  Down  Real  Line) 

Control-N  moves  vertically  .straight  down.  See  section  3  {Control-N],  page  13. 

Control-!’  (~R  Up  Real  Line) 

Control-!’  moves  vertically  straight  up.  See  section  3  [Control-!*].  page  13. 

ControJ-R  (-R  Reverse  Search) 

Control-R  is  like  Control-S  but  searches  backward.  Sec  section  10  {Control-R],  page  41. 
Control-S  (~R  Incremental  Search) 

Control-S  searches  for  a  string,  terminated  by  Altmodc.  It  searches  as  you  type.  See 
section  10  {Control-S],  page  41. 

Mcta-<  (~R  Goto  Beginning) 

Mcta-<  moves  to  the  beginning  of  the  buffer.  See  section  3  {Mcta-<J.  page  13. 

Mcta->  {'•R  Goto  Imd) 

Mcta->  moves  to  the  end  of  the  buffer.  See  section  3  ]Mcla->],  page  13. 

Conlrol-X  Control-N  ("R  Set  Goal  Column) 

Control-X  Control-N  sets  a  horizontal  goal  for  the  Control-N  and  Control-!’  commands. 
When  there  is  a  goal,  those  commands  try  to  move  to  the  goal  column  instead  of  straight 
up  or  down. 
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Lines 

Return  (AR  CRLF) 

Return  inserts  a  line  separator,  or  advances  onto  a  following  blank  line.  Sec  section  3 
[Return),  page  13. 

Control-0  (AR  Open  Line,  built-in  function) 

Control-0  inserts  a  line  separator,  but  point  stays  before  it.  See  section  3  [Control-O], 
page  13. 

Control-X  Control-0  (AR  Delete  Blank  Lines) 

Control-X  Control-0  deletes  all  but  one  of  the  blank  lines  around  point.  If  the  current  line 
is  not  blank,  all  blank  lines  following  it  arc  deleted.  See  section  3  [Conlrol-X  Control-O], 
page  13. 

Control-X  Control- 1'  ("'ll  Transpose  Lines) 

Control-X  Control-T  transposes  ihe  contents  of  two  lines.  See  section  12  [Control-X 
Control-’!'],  page  53. 


Killing  ami  Un-killing 

Rubcuit  (AR  Backwaid  Delete  Character,  built-in  function) 

Rubout  deletes  the  previous  character.  See  section  3  [Rnboul],  p-'gc  13, 

Conlml-Rubout  (AR  Backward  Delete  I  lacking  Tabs,  built-in  function) 

Control-Rubout  deletes  the  previous  character,  but  converts  a  tab  character  into  several 
spaces.  Sec  section  20.6  [Conirol-Rubout],  page  93. 

Control-1)  (aR  Delete  Character,  built-in  function) 

Control- D  deletes  the  next  character.  Sec  section  3  [Control-D],  page  13. 

Control-K  (AR  Kill  Line)  ’ 

Control-K  kills  to  the  end  of  the  line,  or,  at  the  end  of  a  line,  kills  the  line  separator.  See 
section  9.1  [Control-K],  page  35. 

Control- W  (AR  Kill  Region) 

Control-W  kills  the  region,  the  text  betwen  point  and  the  mark.  See  section  9.1 
[O»ntrol-W],  page  35.  See  section  8  [Region],  page  31. 

Control- Y  <  R  Un-kill) 

Control- Y  reinserts  the  last  saved  block  of  killed  text.  See  section  9.2  [Control- Y],  page  37. 
Meta-W  (aR  Copy  Region) 

Meta-W  saves  the  region  as  if  it  were  killed  without  removing  it  from  the  buffer.  See 
section  9.2  [Meta-W],  page  37. 

Meta-Y  (aR  Un-kill  Pop) 

Meta-Y  rolls  the  kill  ring  to  reinsert  saved  killed  text  older  titan  the  most  recent  kill.  See 
section  9.2  [Meta-Y],  page  37. 
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Control-Mcta-W  (AR  Append  Next  Kill) 

Control-Mcta-W  causes  an  immediately  following  kill  command  to  append  its  text  to  the 
last  saved  block  of  killed  text.  See  section  9.2  [Control-Mcta-W],  page  37. 

CoiU:i>l-X  T  (AR  Transpose  Regions) 

Control-X  T  transposes  two  arbitrary  regions  defined  by  point  and  the  last  three  marks. 
See  section  12  [Control-X  1’].  page  S3. 


Scrolling  and  Display  Control 

Controi-L  (AR  New  Window) 

Control-!.  dears  the  screen  and  centers  point  in  it.  With  an  argument,  it  can  put  point  on  a 
specific  line  of  the  screen.  Sec  section  15  [Control-!. J,  page  71. 

Control- V  (AR  Next  Screen) 

Control- V  scrolls  downward  by  a  screenful  or  several  lines.  See  section  15  [Conirol*V], 
page  71. 

Meta-R  (AR  Move  to  Screen  Hdge) 

Meta-R  moves  point  to  beginning  of  the  text  on  a  specified  line  of  the  screen.  See 
section  15  [Mcta-R|,  page  71. 

Meta-V  ("R  Previous  Screen) 

Meta-V  :c rolls  upward  by  a  screenful  or  several  lines.  See  section  15  [Meta-Vj,  page  71. 
ControTMeta-R  (AR  Reposition  Window) 

Control- Meta-R  tries  to  center  on  the  scrcci.  the  function  or  paragraph  you  arc  looking  at. 
Sec  section  15  [ControTMeta-R],  page  71. 

Control-Mcta-V  (AR  Scroll  Other  Window) 

Control-Mcta-V  scrolls  the  other  window  up  or  down,  when  you  arc  in  two  window  mode. 
See  section  16  [Control-Mcta-V],  page  73. 


The  Mark  and  the  Region 

ControK  (AR  Mark  beginning) 

ControK  sets  the  mark  at  the  beginning  of  the  buffer.  See  section  8  (ControK],  page  31. 
ControT>  OR  Mark  lind) 

Control-)  sets  the  mark  at  the  end  of  the  buffer.  See  section  8  [Control-)],  page  31. 
Control-^1  (AR  Set/Pop  Mark) 

Control-^*  sets  the  mark  or  moves  to  the  location  of  the  maik.  See  section  8  |Conirol-(fr,|, 
page  31... 

Mcla-@>  (aR  Mark  Word) 

Mcta-@  puts  the  mark  at  the  end  of  the  next  word.  See  section  11.1  [Meta-t^],  page  43. 


Meta-ll  (aR  Mark  Paragraph) 
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Mcta-H  puts  point  at  the  beginning  of  the  paragraph  and  the  mark  at  die  end.  See 
section  1 1.2  [Mcta-H  j,  page  44. 

Control-Mcta-@  (AR  Mark  Sexp) 

Comrol-Mcta-t®  puts  the  mark  at  the  end  of  die  next  s-expression.  Sec  section  20.6.1 
[Control-Mcta-@],  page  94. 

Control-Mcta-H  (*R  Mark  DEFUN) 

Control-Mcta-H  puts  point  at  the  beginning  of  the  current  DEFUN  and  the  mark  at  the 
end.  See  section  20.6.2  [Control-Mcta-H],  page  95. 

Control-X  H  (AR  Mark  Whole  Buffer) 

Conlrol-X  H  puts  point  at  the  beginning  of  the  buffer  and  die  mark  at  the  end.  Sec 
section  8  [Control-X  1 1],  page  31. 

Control-X  Control-P  (AR  Mark  Page) 

Control-X  Control-P  puts  point  at  the  beginning  of  the  current  page  and  the  mark  at  die 
end.  See  section  18  [Control-X  Control-P],  page  79. 

Control-X  Control-X  (~R  Exchange  Point  and  Mark) 

Control-X  Control-X  sets  point  where  die  mark  was  and  die  mark  where  point  was.  See 
section  8  [Control-X  Control-X],  page  31. 


Whitespace  anti  Indentation 

Tab  (AR  Indent  According  to  Mode) 

Tab  either  adjusts  the  indentation  of  the  current  line  or  inserts  some  indentadon,  in  a  way 
dial  depends  on  the  major  mode.  See  section  11.3  [Indentating  Text],  page  46.  See 
section  20.3  [Indentating  Programs],  page  89. 

« 

Linefeed  (AR  Indent  New  Line) 

Linefeed  is  equivalent  to  Return  followed  by  Tab.  It  moves  to  a  new  line  and  indents  that 
line.  If  done  in  die  middle  of  a  line,  it  breaks  the  line  and  indents  the  new  second  line.  See 
section  1 1.3  [Linefeed],  page  46. 

Meta-Tab  (AR  Tab  to  Tab  Slop) 

Meta-Tab  indents  to  the  next  EMACS-defined  tab  stop.  See  section  11.3  [Meta-Tab], 
page  46. 

Meta-M  (AR  Back  to  Indentation) 

Meta-M  pi  sitions  the  cursor  on  the  current  iinc  after  any  indentation.  See  section  11.3 
[Meta-M],  page  46. 

MetaA  (  'R  Delete  Horizontal  Space) 

Mcta-\  deletes  all  spaces  and  tab  characters  around  point  See  section  11.3  [MetaA], 
page  46. 

Mcta-A  (AR  Delete  Indentation) 

Mcta-A  joins  two  lines,  replacing  the  indentation  of  the  second  line  with  zero  or  one  space, 
according  to  the  context.  See  section  11.3  [Meta-*],  page  46. 
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ControTMcta-0  (^R  Split  Tine) 

ControTMcta-0  breaks  a  line,  preserving  the  horizontal  position  of  the  second  half  by 
indenting  it  to  its  old  stinting  position.  See  section  1 1.3  [ControTMcta-0],  page  46. 

ControTMetaA  (~R  Indent  Region) 

ControTMetaA  indents  each  line  in  die  region,  cidicr  by  applying  lab  to  each  line,  or  by 
giving  each  die  same  specified  amount  of  indentation.  See  section  11.3  [ControTMetaA], 
page  46. 

ControTX  Tab  (~R  Indent  Rigidly) 

ControTX  Tab  shifts  all  the  lines  in  the  region  right  or  left  the  same  number  of  columns. 
See  section  1 1.3  [ControTX  Tab],  page  46. 


Words,  Sentences  and  Paragraphs 

ControTX  Rollout  (~R  Backward  Kill  Sentence) 

ControTX  Ruboul  kills  back  to  the  beginning  of  the  sentence.  See  section  1 1.2  [ControTX 
Rollout],  page  44. 

Meta-A  (~R  Backward  Sentence) 

Meta-A  moves  to  the  beginning  of  die  sentence.  See  section  1  i.2  [Meta-A],  page  44. 

Meta-B  (~R  Backward  Word) 

Meta-B  moves  backward  one  word.  See  section  11.1  [Meta-B],  page  43. 

Mcta-I)  (~R  Kill  Word) 

Mcta-I)  kills  one  word  forward.  See  section  1 1.1  [Mcla-D],  page  43. 

Mcla-K  CR  Forward  Sentence) 

Meta-H  moves  to  the  end  of  the  sentence.  See  section  1 1.2  [Meta-H],  page  44. 

Meta-F  CR  Forward  Word) 

Meta-F  moves  foi  ward  one  word.  See  section  1 1 . 1  [Meta-FI,  page  43, 

Mcta-1 1  (*R  Mark  Paragraph) 

Meta-H  puls  point  at  the  front  of  die  current  paragraph  and  the  mark  at  die  end.  See 
section  11.2  [Mcta-1 1],  page  44. 

Meta-K  ("R  Kill  Sentence) 

Meta-K  kills  to  the  end  of  die  sentence.  See  section  11.2  [Meta-K],  page  44. 

Meta- 1’  ('R  Transpose  Words) 

Meta-T  transposes  two  consecutive  words.  See  section  11.1  [Mcta-1],  page  43. 

Meta-[  (~R  Backward  Paragraph) 

Mcta-[  moves  to  the  beginning  of  the  paragraph.  See  section  1 1.2  [Mcta-[],  page  44. 

Meta-]  CR  Forward  Paragraph) 

Meta-]  moves  to  the  end  of  the  paragraph.  See  section  1 1.2  [Mela-]],  page  44. 

Meta-Rubout  ("R  Backward  Kill  Word) 
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Meta-Rubout  kills  the  previous  word.  See  section  11.1  [Meta-Kubout],  pagc43. 


Filling  Text 

Meta-G  (aR  Fill  Region) 

Meta-G  fills  the  region,  treating  it  (usually)  as  one  paragraph.  See  section  11.4  [Meta-G], 
page  47. 

Mcla-Q  (aR  Fill  Paragraph) 

Meta-Q  fills  the  current  or  next  paragraph.  See  section  1 1.4  [Meta-Q],  page  47. 

Meta-S  CR  Center  Line) 

Meta-S  centers  the  current  line.  See  section  1 1.4  [Meta-S],  page  47. 

Control-X  :  (~R  Set  Fill  Prefix) 

Control-X  :  specifies  the  fill  prefix,  which  is  used  for  filling  indented  text.  See  section  11.4 
IControl-X  Colon],  page  47. 

Control-X  F  (AR  Set  Fill  Column) 

Control-X  I-'  sets  the  variable  Fill  Column  which  controls  the  margin  for  filling  and 
centering.  See  section  11.4[Control-X  F],  page  47. 


Exiting 

* 

Control-]  (Abort  Recursive  Hdit) 

Control-]  aborts  a  recursive  editing  level;  that  is  to  say.  exits  it  without  allowing  the 
command  which  invoked  it  to  finish.  See  section  24.1  [Control-]],  page  129. 

Control-Mcta-C  CR  l-'xit.  built-in  function) 

Control- Meta-C  exits  from  a  recursive  editing  level  and  allows  the  command  which 
invoked  the  recursive  editing  level  to  finish.  At  top  level,  it  exits  from  HMACS  to  its 
superior  job.  Sec  section  6.3  [Control-Mcta-C],  page  26. 

Control-X  Control-C  ("R  Return  to  Superior) 

Control-X  Control-C  returns  from  HMACS  to  its  superior  job,  even  if  HMACS  is  currently 
inside  a  recursive  editing  level.  In  that  ease,  re-entering  HM  ACS  will  find  it  still  within  the 
recursive  editing  level.  See  section  6.3  [Control-X  Control-C],  page  26. 


Pages 

Control-X  1.  (*R  Count  I  .incs  Page) 

Control-X  L  prints  the  number  of  lines  on  the  current  page,  and  how  many  come  before 
point  and  how  many  come  after.  See  section  18  [Control-X  L],  page  79. 

Control-X  P  (~R  Set  Bounds  Page) 

Control-X  P  narrows  the  virtual  boundaries  to  the  current  page.  See  section  17  [Control-X 
P],  page  77. 
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Control-X  [  ("R  Previous  Page) 

Centrol-X  [  moves  backward  to  the  previous  page  boundary.  See  section  18  [Control-X  []. 
page  79. 

Control-X  ]  (“R  Next  Page) 

Control-X  ]  moves  forward  to  the  next  page  boundary.  See  section  18  [Control-X  ]), 
page  79. 

Control-X  Control-P  CR  Mark  Page) 

Control-X  Control-P  puts  point  at  the  beginning  and  the  mark  at  the  end  of  the  current 
page.  See  section  18  [Control-X  Control-P),  page  79. 


Lisp 

Mcta-(  ['•RMakcOJ 

Mcta-(  places  a  pair  of  paicnthcscs  around  the  next  several  s-expressions.  See 
section  20.6.1  [Mcta-(],  page  94. 

Meta-)  L  R  Move  Over )] 

Meta-)  moves  past  the  next  close  parenthesis  and  adjusts  the  indentation  of  the  following 
line.  See  section  20.6.1  [Meta-)],  page  94. 

Control-Mcta-Tab  CR  Indent  for  I.isp) 

Control-Mctn-Tab  adjusts  the  indentation  of  the  current  line  for  proper  I.isp  style.  See 
section  20.3  |Control-Meta-Tab],  page  89. 

Control-Mcta-(  (~R  Backward  Up  List) 

Control- Mcla-(  moves  backward  up  one  level  of  list  structure.  See  section  20.6.1 
[Conliol-Mcta-(l,  page  94. 

Control-Mcta-)  (*R  Up  List) 

Control-Meta-)  moves  forward  up  one  level  of  list  structure.  See  section  20.6.1 
[Conliol-Mcta-)j,  page  94. 

Control-Mcta-@  (AR  Mark  Sexp) 

Control-Mcta-^1  puts  the  mark  at  the  end  of  the  next  s-expression.  See  section  8 
[Control- Mcta-@],  page  31. 

Control-Mcta-A  (*R  Beginning  of  DKFUN) 

Control-Mcta-A  moves  to  die  beginning  of  the  current  DKFUN.  See  section  20.6.2 
[Control-Mcta-A],  page  95. 

Control- M eta- B  (~R  Backward  Sexp) 

Control-Mcta-B  moves  backward  over  one  s-expression.  See  section  20.6.1 
[Control- Meta- B],  page  94, 

Control-Mcla-D  ("R  Down  l.ist) 

Control-Meta-I)  moves  forward  and  down  a  level  in  list  structure.  Sec  section  20.6.1 
[Conlrol-Mcta-nj,  page  94. 


Controi-Meta-K  (~R  Knd  of  DKFUN) 
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Control-Mcta-K  moves  to  die  end  of  the  current  DHFUN.  See  section  20.6.2 
[Control- Mela- K],  page  95. 

Control-Mcta-F  (AR  Forward  Scxp) 

Control- Mcta-F  moves  forward  over  one  s-expression.  Sec  section  20.6.1 
(ControI-Mcta-FJ,  page  94. 

Comtrol-Mcta-G  (AR  Format  Code) 

Control-Mcta-G  grinds  the  s-expression  after  point.  See  section  20.7  [Control-Mcta-G], 
page  96. 

Control-Mcta-H  (AR  Mark  DF.FUN) 

Control-Mcta-H  puts  point  before  and  the  mark  after  the  current  or  next  DHFUN.  See 
section  20.6.2  [Control-Mcta-H],  page  95. 

Control-Meta-K  ("'ll  Kil  Scxp) 

Control-Mcta-K  kills  the  following  s-expression.  See  section  20.6.1  [Control-Mcta-K], 
page  94. 

Control-Meta-N  (AR  Next  l  ist) 

Control-Mcta-N  moves  forward  over  one  list,  ignoring  atoms  before  the  first  open 
parenthesis.  See  section  20.6.1  [Conirol-Mcta-N],  page  94. 

Control-Meta-P  (~R  Previous  List) 

Control-Meta-P  moves  backward  over  one  list,  ignoring  atoms  reached  before  die  first 
close  parenthesis.  Sec  section  20.6.1  [Control-Meta-P],  page  94. 

Control-Mcia-Q  (AR  Indent  Scxp) 

Control- Meta-Q  adjusts  the  indentation  of  each  of  the  lines  in  the  following  s-expression, 
but  not  the  current  line.  See  section  20.3  (Control-Mcta-Q],  page  89. 

Control-Mcta-T  (AR  Transpose  Scxps) 

Control-Meta-T  transposes  two  consecutive  s-expressions.  Sec  section  20.6.1 
[Control-Mcta-Tj.  page  94. 

Control-Meta-U  (AR  Backward  Up  I.ist) 

Control -Meta- U  moves  backward  up  one  level  of  list  structure.  Sec  section  20.6.1 
[Control-Meta-U],  page  94. 


Files 

Me ’.a-.  (aR  Find  'lag) 

Meta;,  moves  to  the  definition  of  a  specific  function,  switching  files  if  necessary.  Sec 
section  21  [Mela-.],  page  101. 

Mcta-~  (aR  Buffer  Not  Modified) 

Meta—  clears  the  flag  which  says  that  the  buffer  contains  changes  that  have  not  been 
saved.  Sec  section  13.1  [Mcta-~],  page  55. 

Control-X  Control-F  (Find  File) 

Control-X  Control-F  visits  a  file  in  its  own  buffer.  See  section  14  [Control-X  Control-17], 
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page  67. 

Control-X  Control-Q  (~R  Do  Not  Write  File) 

Control-X  Control-Q  tells  F.MACS  not  to  offer  to  save  this  file.  Sec  section  13  [Control-X 
Control-Q],  page  55. 

Control-X  Control'll  (*R  Read  File) 

Control-X  Control- R  visits  a  file  and  tells  HMACS  not  to  offer  to  save  it.  See  section  13.1 
[Control-X  Control-R],  page  55. 

Control-X  Control-S  (*R  Save  File) 

Control-X  Control-S  saves  the  visited  file.  See  section  13,1  [Control-X  Control-S],  page  55. 
Control-X  Control-V  (*R  Visit  Hie) 

Control-X  Control- V  visits  a  file.  See  section  13.1  [Control-X  Control-V],  page  55. 
Control-X  Control-W  (Write  File) 

Control-X  Control-W  saves  the  file,  asking  for  names  to  save  it  under.  See  section  13.7 
[Control-X  Control-W],  page  63. 


File  Directories 

Control-X  D  <*R  DIR  HD) 

Control-X  D  invokes  the  directory  editor  DIRHD,  useful  for  deleting  many  files.  See 
section  13.6  [Control-X  D],  page  60. 

Control-X  Control-!)  (*R  Directory  Display) 

Control-X  Control-!)  displays  a  subset  of  a  directory.  See  section  13.1  [Control-X 
Control-1)],  page  55. 


Buffers 


Control-X  A  (*■11  Append  to  Buffer) 

Control-X  A  adds  the  text  of  region  into  another  buffer.  Sec  section  9.3  [Control-X  A], 
page  38. 

Control-X  B  (Select  Buffer) 

Control-X  B  is  the  command  for  switching  to  another  buffer.  See  section  14  [Control-X  B], 
page  67. 

Control-X  K  (Kill  Buffer) 

Control-X  K  kills  a  buffer.  See  section  14  [Control-X  K],  page  67. 
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Comments 

Meta-Linefeed  (~R  Indent  New  Comment  Line) 

Mcta-I  .inefeed  moves  to  a  new  line  and  indents  it  If  point  had  been  within  a  comment  on 
the  old  line,  a  new  comment  is  started  on  the  new  line  and  indented  under  the  old  one. 
See  section  20.5  (Meta-Linefeed],  page  91. 

Meta-:  (~R  Indent  for  Comment) 

Meta-:  inserts  a  properly  indented  comment  at  die  end  of  the  current  line,  or  adjusts  the 
indentation  of  an  existing  comment  Sec  section  20.5  (Meta-;],  page  91. 

Meta-N  (~R  Down  Comment  Line) 

Meta-N  moves  down  a  line  and  starts  a  comment,  deleting  empty  comments.  Sec 
section  20.5  [Meta-N],  page  91. 

Meta-P  (~R  Up  Comment  Line) 

Meta-P  moves  down  a  line  and  starts  a  comment,  deleting  empty  comments.  See 
section  20.5  (Meta-P],  page  91. 

Control-Mcta-;  (~R  Kill  Comment) 

Control-Meta-;  kills  any  comment  on  die  current  line.  See  section  20.5  [Control-Mcta-;]. 
pagc9L  . 

Control-X  ;  (~R  Set  Comment  Column) 

Control- X  :  sets  the  column  at  which  comments  arc  indented,  from  an  argument,  the 
current  column,  or  the  previous  comment.  See  section  20.5  (Control-X  ;].  page  91. 


Case  Conversion 

Meta-C  (~R  Uppercase  Initial) 

Meta-C  makes  the  next  word  lower  ease  widi  a  capital  initial.  It  moves  over  the  word.  Sec 
section  11.5  (Meta-C],  page  49. 

Meta-L  (~R  Lowercase  Word) 

Meta-L  moves  over  a  word  converting  it  to  lowercase.  See  section  1 1.5  [Meta-LJ,  page  49. 
Meta-U  CR  Uppercase  Word) 

Meta-U  moves  over  a  word  converting  it  to  tippet  ease.  See  section  1 1.5  [Meta-U],  page  49. 

Control-X  Control-!.  (~R  Lowercase  Region) 

Control-X  Control-!,  converts  the  text  of  the  region  to  lower  ease.  Sec  section  11.5 
[Control-X  Control-!.],  page  49. 

Control-X  Control-U  ("R  Uppercase  Region) 

Control-X  Control-U  converts  the  text  of  the  region  to  upper  ease.  See  section  1 1.5 
(Control-X  Control-U],  page  49. 
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Windows 

Contiol-Meta-V  ('  R  Scroll  Other  Window) 

Control* Meta- V  scrolls  die  other  window  up  or  down.  See  section  15  [Control-Meta-V], 
page  71. 

Control-X  1  (~R  One  Window) 

Control-X  1  stops  displaying  two  windows.  See  section  16  [Control-X  1],  page  73. 
Control-X  2  (~R  Two  Windows) 

Control-X  2  displays  two  windows.  See  section  16  [Control-X  2).  page  73. 

Control-X  3  (~R  View  Two  Windows) 

Control-X  3  displays  two  windows  but  stays  in  the  first  one.  See  section  16  [Control-X  3], 
page  73. 

Control-X  4  (-R  Visit  in  Other  Window) 

Control-X  4  displays  two  windows  and  selects  a  buffer  or  visits  a  file  in  the  other  window. 
See  section  16  [Control-X  4],  page  73. 

Control-X  0  (“R  Other  Window) 

Control-X  O  switches  from  one  window  to  the  other.  See  section  16  [Control-X  Q], 
page  73. 

Control-X  A  (~R  Grow  Window) 

Coni  jI-X  "  changes  the  allocation  of  screen  space  to  the  two  windows.  See  section  16 
[Control-X  •'[.  page  73. 


Narrowing 

Control-X  N  CR  Set  Bounds  Region) 

Control-X  N  narrows  the  virtual  boundaries  to  the  region  as  it  was  before  die  command. 
See  section  17  [Control-X  N],  page  77. 

Control-X  P  ("R  Set  Bounds  Page) 

Control-X  P  narrows  the  virtual  boundaries  to  the  current  page.  See  section  18  [Control-X 
P[,  page  79. 

Conttol-X  W  CR  Set  Bounds  Full) 

Control-X  W  widens  the  virtual  boundaries  back  to  the  entire  buffer.  See  section  17 
[Control-X  W],  page  77. 


Status  Information 

Control-X  =  (What  Cursor  Position) 

Control-X  =  prints  information  on  the  screen  position  and  character  position  of  the 
cursor,  the  si/c  of  the  file,  and  the  character  after  die  cursor.  Sec  section  1 1.4  [Control-X 
=],  page  47. 
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Control-X  I.  (~R  Count  Lines  Page) 

Control-X  I.  prints  the  number  of  lines  in  the  current  page,  and  how  many  come  before  or 
after  point.  See  section  18[Contro!-X  L],  page 79. 


Keyboard  Macros 

Control-X  (  ("R  Start  Kbd  Macro) 

Control-X  ( begins  defining  a  keyboard  macro.  See  section  22.8  (Control-X  (],  page  124. 
Control-X  )  CR  Knd  Kbd  Macro) 

Control-X  )  terminates  the  definition  of  a  keyboard  macro.  See  section  22.8  [Control-X  )(, 
page  124. 

Control-X  1-  (~R  Call  Last  Kbd  Macro) 

Control-X  I:  executes  the  most  recently  defined  keyboard  macro.  See  section  22.8 
[Control-X  1-],  page  124. 

Control- X  Q  (“R  Kbd  Macro  Query) 

Control-X  Q  in  a  keyboard  macro  can  ask  the  user  whether  to  continue  or  allow  hint  to  do 
some  editing  before  continuing  with  the  keyboard  macro.  Sec  section  22.8  (Control-X  Q|, 
page  124. 


MinibulTer 

«* 

Control-%  ("R  Replace  String) 

ControI-%  invokes  a  niiniluiffcr  containing  a  call  to  Replace  String.  You  fill  in  the 
arguments.  See  section  19  [Control-%],  page  83. 

Mcta-Altmodc  (~R  Hxccutc  Minibuffer) 

Meta-AItmodc  invokes  an  empty  minibuffer  which  you  can  fill  in  with  a  THCO  program  to 
be  executed.  See  section  23  (Mcta-Altmodc),  page  127. 

Mcta-%  ("R  Query  Replace) 

Mcta-%  invokes  a  minibuffer  containing  a  call  to  Query  Replace.  You  fill  in  the 
arguments.  See  section  19  [Mcta-%],  page  83. 

Control-X  Altmodc  ("R  Re-execute  Minibuffer) 

Control-X  Altmodc  re-executes  a  TKCO  program  previously  executed  in  the  minibuffer. 
It  can  also  re-execute  an  extended  command.  See  section  23  [Control-X  Altmodc], 
page  127. 
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Libraries  Used  Explicitly 

These  arc  libraries  which  you  must  load  with  M-X  l  oad  I.ioraryKIibnamcXcr>  to  use.  if  no 

cross-reference  is  given,  the  only  documentation  for  the  library  is  the  self-documentation  contained  in  it.  Use 

M-X  List  LibraryKiibnamcXcr>  to  print  a  brief  description  of  each  function  in  the  library.  For  more 

detailed  information,  load  the  library  and  use  M-X  Describe  on  individual  functions. 

AHSTR  contains  commands  for  making  documentation  files:  wall  charts,  and  abstracts  of  libraries. 

See  the  file  INFO;CONV  >,  node  Top. 

AUTO-S  is  an  alternate  implementation  of  Auto  Save  mode.  It  has  some  features  which  ihc 

standard  version  lacks,  and  hicks  some  which  the  standard  version  has. 

BABYL  is  a  subsystem  for  reading,  sending  and  editing  mail.  See  the  file  INFOtBABYI.  >,  node 

Top. 

HCPL  implements  HCPL  mode. 

Ill  ISS  implements  111  .ISS  mode. 

C1IKSS  implements  commands  for  editing  pictures  of  chessboards. 

COLUM  NS  implements  commands  for  converting  single-column  text  into  double-column  text  and  vice 
versa. 

DLl.lM  implements  commands  for  moving  over  balanced  groupings  of  various  kinds  of 

parentheses.  ’Ihcrc  arc  a  pair  of  commands  for  square  brackets,  a  pair  for  angle  brackets, 
etc. 

DOC1.SP  prints  documentation  from  the  Macl.isp  manual  on  a  specified  Lisp  function. 

OOCOND  is  a  macro  processor  and  conditionalizcr  for  text  files,  useful  for  maintaining  multiple 
versions  of  documents  with  one  source. 

KAK  MACS  KAK’s  personal  library. 

FORTRAN  implements  FOR  I  RAN  mode. 

I  IA/.1510  redefines  commands  to  be  convenient  on  I  la/cllinc  1510  terminals. 

INFO  peruses  tree-structured  documentation  files. 

is  KAK  and  FjCC’s  own  generator  for  F.MACS  libraries,  which  uses  a  slightly  different 
input  formal.  Hie  libraries  KAK  MACS.  IVORY.  MKDUMP,  TMACS  and  WORDAB. 
and  all  of  BABYI ..  are  generated  with  IVORY. 
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186 


KM  ACS  Manual  for  IIS  Users 


JOURNAL 

I.KD1T 

L1SPJ- 

LUNAR 

MACCNV 

MAZLIB 

MKDUMP 

MODI. IN 

MQRI-PL 

NKWS 

OUTLIN 

PAGK 

PASCAL 
PH RASH 
PIC1URK 

PL1 

PUR  IKY 

QSKND 

RENUM 

RMAIL 

RUNOFF 

SCRI.1N 

SLOWLY 

TDI-BUG 


implements  journal  files.  See  section  24.4  (Journals),  page  133. 
is  the  KM  ACS  side  of  the  KMACS-to-Maci.isp  interface.  See  the  file  1NF0;LKDIT  >. 
is  the  KM  ACS  side  of  another  KMACS-to-MacLisp  interface.  See  the  file  INFOlLISPI*  >. 
is  Moon’s  personal  library. 

docs  part  of  the  work  of  converting  MACRO-10  code  to  MIDAS  code, 
is  a  game  for  solving  mazes.  It’s  fun  to  play, 
aids  in  dumping  your  own  customized  environment 
implements  a  fancier  mode  line  display. 

works  with  TAGS  to  perform  several  Query  Replaces  on  each  nf  the  files  in  a  tag  table, 
is  for  reading  the  latest  AP  or  New  York  ‘limes  news  summary, 
implements  Outline  mode,  for  editing  outlines. 

defines  commands  for  viewing  only  one  page  of  the  file  at  a  time.  Sec  section  18.1 
(PAGKJ.  page  80. 

implements  PASCAL  mode.  See  the  file  INFO;KPASC  >. 
has  commands  for  nun  ing  over  and  killing  phr.^cs  of  text 

contains  Kdit  Picture,  the  command  for  editing  text  pictures.  See  section  26  (PICI'URK]. 
page  151. 

implements  I’Ll  mode.  See  the  file  INFO; KPL1  >. 

generates  libraries  from  KMACS  source  files,  and  contains  other  functions  useful  for 
editing  the  source  files.  See  the  file  INFO;CONV  >. 

sends  a  message  to  another  logged-in  user,  like  :QSEN1). 

renumbers  figures,  equations,  theorems  or  chapters. 

is  for  reading,  editing  and  sending  mail. 

is  for  text-justified  documents  divided  into  separate  source  files.  It  rejustifies  the  files 
which  have  changed,  then  runs :(ri‘  to  print  only  the  pages  which  have  changed. 

contains  alternative  definitions  of  C-N  and  C-P  which  move  by  screen  lines  instead  of  by 
real  lines. 

redefines  commands  and  options  to  suit  slow  terminals. 

is  a  debugger  forTHCO  programs,  it  displays  the  buffer  in  one  window  and  the  program 
in  the  other,  while  stepping  by  lines  or  setting  breakpoints.  See  the  file  INFO; 
TDKIHJG  >.  node  Top. 
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TEX  implements  TEX  mode. 

TIME  causes  the  current  time  of  day  to  be  displayed  in  the  mode  line. 

TMACS  contains  miscellaneous  useful  functions 

VT100  defines  the  arrow  keys  and  numeric  keypad  of  the  VT-100  terminal  to  move  the  cursor  and 

supply  numeric  arguments. 

VT52  defines  the  numeric  keypad  of  the  VT-52  terminal  to  supply  numeric  arguments. 

Automatically  Loaded  Libraries 

These  arc  libraries  which  the  user  need  not  know  about  to  use. 

AUX  implements  several  commands  described  in  the  manual  as  part  of  the  standard  EMACS. 

Loaded  automatically  when  needed. 

BABYLV  is  an  auxiliary  library  for  BABYL. 

BARE.  contains  the  definitions  of  all  built-in  functions.  These  definitions  arc  not  needed  for 

executing  the  built-in  functions,  only  so  that  Help  can  describe  them  properly.  Loaded 
automatically  by  documentation  commands  when  needed.  Sec  section  5.2  (BARE'], 
page  21. 

DIRED  implements  the  commands  for  editing  and  listing  directories.  Loaded  automatically  when 

needed.  See  section  13.6  (1)1  RET)],  page  60. 

H1N1T  is  used  in  building  and  dumping  EMACS.  Sec  the  file  INKO;CONV  >. 

EMACS  is  the  main  body  of  standard  EMACS.  Always  loaded. 

GRIND  implements  C-M-G.  Loaded  automatically  when  needed.  See  section  20.7  [Grinding!, 

page  96. 

KBDMAC  implements  keyboard  macros.  Loaded  automatically  when  needed.  See  section  22.8 
(Keyboard  Macros],  page  124. 

KEYSET  is  an  auxiliary  file  for  BABYL. 

SORT  implements  the  sorting  commands.  Loaded  automatically  when  needed. 

SVMHNU  is  an  auxiliary  file  for  BABYL. 

TAGS  implements  the  TAGS  package.  See  section  21  (TAGS],  page  101. 

implements  Word  Abbrev  mode,  loaded  automatically  when  needed.  See  section  25 
(WORDABJ,  page  141. 


WORDAB 
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An  option  is  a  variable  whose  value  Edit  Options  offers  for  editing.  A  hook  variable  is  a  variable  which  is 
normally  not  defined,  but  which  you  can  define  if  you  wish  for  customization.  Most  hook  variables  require 
TFCO  programs  as  their  values. 

'lhe  default  value  of  the  variable  is  given  in  parentheses  after  its  name.  If  no  value  is  given,  the  default 
value  is  zero.  If  the  word  "nonexistent"  appears,  then  the  variable  does  not  exist  unless  you  create  it 

Abort  Resumption  Message 

'lliis  is  the  message  to  be  printed  by  C-]  to  tell  you  how  to  resume  the  aborted  command. 
If  this  variable  is  zero,  there  is  no  way  to  resume,  so  C-]  asks  for  confirmation.  Sec 
section  24.1  [Quitting],  page  129. 

Additional  Abbrev  Expanders  (nonexistent) 

If  this  variable  exists  when  Word  Abbrev  Mode  is  turned  on.  it  is  string  of  characters  which 
should  terminate  and  expand  an  abbrev,  in  addition  to  the  punctuation  characters  which 
normally  do  so.  See  also  WOR1MB  Ins  Chars. 


Atom  Word  Mode 

'flic  minor  mode  Atom  Word  mode  is  on  if  this  variable  is  nonzero.  See  section  22.1 
[Atom  Word  ModeJ.  page  1 1 1, 

Auto  Directory  Display 

If  this  is  nonzero,  certain  file  operations  automatically  display  the  file  directory.  See 
section  13.1  [Auto  Directory  Display],  page  55. 

Auto  Fill  Mode  Hie  minor  mode  Auto  Mil  inode  is  on  if  this  variable  is  nonzero.  See  section  1 1.4  (Auto 
1-ill  Mode],  page  47. 

Auto  Push  Point  Notification 

'Ihc  value  of  this  variable  is  the  siring  printed  in  the  echo  area  by  some  commands  to 
notify  you  that  the  mark  has  been  set  to  the  old  location  of  point  See  section  10  [Auto 
Push  Point  Notification],  page  41. 

Auto  Push  Point  Option  (500) 

Searches  set  the  mark  if  they  move  at  least  this  many  characters.  See  section  10  [Auto  Push 
Point  Option},  page  41. 


Auto  Save  Default 

'Ihc  minor  mode  Auto  Save  mode  is  on  by  delimit  for  newly  visited  files  if  this  variable  is 
nonzero.  See  section  13.3  [Auto  Save  Default],  page  57. 

Auto  Save  Filenames (DSK:<working  dircctory>;_''RSV  >) 

These  arc  the  filenames  used  for  auto  saving  if  the  visited  filenames  are  not  used.  See 
section  13.3  [Auto  Save  Filenames],  page  57. 

Auto  Save  Interval  (500) 

'lliis  is  the  number  of  characters  between  auto  saves.  See  section  13.3  [Auto  Save  Interval], 
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page  57. 

Auto  Save  Max  (2) 

ibis  is  the  maximum  number  of  auto  saves  to  keep.  Sec  section  13.3  [Auto  Save  Max], 
page  57. 

Auto  Save  Visited  File 

If  this  is  nonzero,  auto  saving  saves  as  the  visited  filenames.  If  this  is  zero,  auiO  saving 
saves  as  the  names  which  arc  the  value  of  Auto  Save  Filenames  (q.v.).  See  section  13.3 
[Auto  Save  Visited  File],  page  57. 

Autoarg  Mode  When  Autoarg  Mode  is  nonzero,  numeric  arguments  can  be  specified  just  by  typing  the 
digits.  See  section  4  [Autoarg  Mode],  page  17. 

Buffer  Creation  Hook  (nonexistent) 

If  this  variable  exists,  its  value  should  be  a  TRCO  program  to  be  executed  whenever  a 
newly  created  buffer  is  selected  for  the  first  time.  Sec  section  14  [Buffer  Creation  Hook], 
page  67. 

Buffer  Deselection  Hook  (nonexistent) 

If  this  variable  exists,  its  value  should  be  a  THCO  program  to  be  executed  whenever  a 
buffer  is  about  to  be  deselected.  The  difference  between  this  and  Buffer  Selection  Hook  is 
that,  while  both  are  executed  (if  they  exist)  when  you  switch  buffers,  this  is  executed  before 
the  switch,  and  Buffer  Selection  Hook  is  executed  after  the  switch.  Sec  section  14  [Buffer 
Deselection  I  look],  page  67. 

Buffer  Selection  Hook  (nonexistent) 

If  tliis  variable  exists,  its  value  should  be  a  TECO  program  to  be  executed  whenever  a 
buffer  is  selected.  Sec  section  14  [Buffer  Selection  Hook],  page  67. 

Case  Replace  (1)  When  Case  Replace  is  nonzero.  Replace  String  and  Query  Replace  attempt  to  preserve 
case  when  they  replace.  Sec  section  19  [Case  Replace],  page  83. 

Comment  Begin  ibis  is  the  string  used  to  start  comments.  If  the  value  is  zero,  semicolon  is  used.  Sec 
section  20.5  [Comment  Begin],  page  91. 

Comment  Column 

ibis  is  the  column  at  which  comments  are  aligned.  Sec  section  20.5  [Comment  Column], 
page  91. 

Comment  End  ibis  is  the  string  which  is  used  to  end  comments.  It  is  often  empty  for  languages  in  which 
comments  end  at  the  end  of  the  line.  Sec  section  20.5  [Comment  End],  page  91. 

Comment  Rounding  (/8  + 1*8) 

ibis  is  the  TECO  program  used  to  decide  what  column  to  start  a  comment  in  when  the  text 
of  the  line  goes  past  the  comment  column,  ibc  argument  to  the  program  is  the  column  at 
which  text  ends.  See  section  20.5  [Comment  Rounding],  page  91. 

Comment  Start  ibis  is  the  siring  used  for  recognizing  existing  comments,  and  for  starting  new  ones  if 
Comment  Begin  is  zero.  If  Comment  Start  is  zero,  semicolon  is  used.  Sec  section  20.5 
[Comment  Shut],  page  91. 


Compile  Command  (nonexistent) 
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If  this  variable  exists,  its  value  should  be  a  TKCO  program  to  be  used  by  the  M-X  Compile 
command  to  compile  the  file.  See  section  20.2  [Compile  Command],  page  88. 

Default  Major  Mode  (Fundamental) 

This  is  the  major  mode  in  which  new  buffers  arc  created.  If  it  is  the  null  string,  new 
buffers  arc  created  in  the  same  mode  as  the  previously  selected  buffer.  Sec  section  14 
[Default  Major  Mode],  page  67. 

Directory  Lister  (&  Subset  Directory  Listing) 

This  is  the  TKCO  program  used  for  listing  a  directory  for  C-X  C-D  and  the  Auto  Directory 
Display  option.  The  default  value  is  the  definition  of  the  function  &  Subset  Directory 
Listing.  Another  useful  value  is  the  definition  of  the  function  &  Rotated  Directory 
Listing. 

Display  Matching  Paren  (-1) 

This  variable  controls  automatic  display  of  the  matching  open  parenthesis  when  a  close 
parenthesis  is  inserted.  See  section  20.4  [Display  Matching  Paren],  page  90. 

1-MACS  Version  This  variable’s  value  is  the  KM  ACS  version  number. 

Kxit  Hook  (nonexistent) 

If  this  variable  exists,  its  value  should  be  a  TKCO  program  to  be  executed  whenever 
KMACS  is  exited.  'ITic  subroutine  &  Kxit  KMACS  is  responsible  for  executing  it  Sec 
section  6.1.  [Kxit  I  look],  page  26. 

Kill  Column  (70)  'Die  value  of  Fill  Column  is  the  width  used  for  filling  text.  See  section  1 1.4  [Fill  Column], 
page  47. 


Fill  Kxtra  Space  List  (.?!) 

'Die  characters  in  this  string  arc  the  ones  which  ought  to  be  followed  by  two  spaces  when 
text  is  filled.  Sec  section  1 1.4  [Fill  Kxtra  Space  I  .ist],  page  47. 

Fill  Prefix  The  value  of  this  variable  is  the  prefix  expected  on  every  line  of  text  before  filling  and 
placed  at  the  front  of  every  line  after  filling.  It  is  usually  empty,  for  filling  nonindented 
text.  See  section  1 1 .4  [Fill  Prefix],  page  47. 

Find  File  Inhibit  Write 

If  this  variable  is  nonzero,  then  C-X  C-F  visits  files  in  read-only  (C-X  C-R)  fashion. 
Normally,  C-X  C-F  visits  files  as  if  C-X  C-V  were  being  used.  See  section  14  [Find  File 
Inhibit  Write],  page  67. 

Indent  Tabs  Mode  (-1) 

If  Indent  Tabs  Mode  is  nonzero,  then  tab  characters  arc  used  by  the  indent  commands. 
Otherwise,  only  spaces  arc  used.  See  section  1 1.3  [Indent  Tabs  Mode],  page  46. 

Inhibit  Write  If  Inhibit  Write  is  nonzero,  then  there  will  be  no  offer  to  save  the  visited  file  if  another  file 
is  visited  in  the  same  buffer.  C-X  C-R  sets  this  variable  nonzero.  Sec  section  13.1  [Inhibit 
Write],  page  55. 

<libname>  Setup  I  look  (nonexistent) 

If  this  variable  exists,  its  value  should  be  a  TKCO  program  to  be  executed  when  the  library 
<Iibi‘.::mc>  is  levied.  The  library's  Setup  function  is  responsible  for  doing  this.  If  the 
library  has  no  Setup  function,  it  will  not  handle  a  setup  hook  either.  See  section  212 
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[Libraries],  page  112. 

<modc>  ..D  (nonexistent) 

’lliis  variable  is  used  by  the  major  mode  <modc>  to  record  Hie  syntax  table  for  that  mode. 
It  is  created  by  the  first  use  of  the  mode,  and  if  you  supply  your  value,  that  value  will  be 
accepted  instead.  For  example.  Text  mode  uses  Text  ..D.  See  section  22.4  [Syntax], 
page  115. 

<modc>  Mode  Hook  (nonexistent) 

If  this  variable  exists,  its  value  should  be  a  TFCO  program  to  be  executed  when  the  major 
mode  <modc>  is  entered.  For  example.  Text  Mode  Hook  is  executed  when  Text  mode  is 
entered.  Sec  section  20  [Major  Modes],  page  87. 

Next  Screen  Context  Lines  (nonexistent) 

If  this  variable  exists,  its  value  should  be  the  number  of  lines  of  overlap  between  one 
screenful  and  the  next,  when  scrolling  by  screens  with  C-V  and  M-V.  Sec  section  15  [Next 
Screen  Context  Lines],  page  71. 

Only  Global  Abbrevs  (nonexistent) 

If  this  variable  exists  and  its  value  is  nonzero,  then  Word  Abbrev  Mode  assumes  that  you 
arc  not  using  any  mode-specific  abbrevs.  See  section  25.2.1  [Only  Global  Abbrevs], 
page  145. 

Overwrite  Mode  If  this  is  nonzero,  the  minor  mode  Overwrite  mode  is  in  effect.  See  section  22.1  [Overwrite 
Mode],  page  111. 

Page  Delimiter  (tl.) 

This  is  the  TFCO  search  string  used  to  recognize  page  boundaries.  See  section  18  [Page 
Delimiter],  page  79. 

PACK  Flush  CRLF(O) 

If  this  is  nonzero,  the  PAG  I:  library  expects  every  page  to  start  with  a  blank  line  which  is 
not  considered  part  of  the  contents  of  the  page.  See  section  18.1  [PAGH  Mush  CRLF], 
page  80. 

Paragraph  Delimiter  (.fO  tO  tO’tO@) 

'lliis  is  the  TFCO  search  string  used  to  recognize  beginnings  of  paragraphs.  Sec 
section  1 1.2  [Paragraph  Delimiter],  page  44. 

Permit  Unmatched  Paren  (-1) 

Controls  whether  the  bell  is  run  if  you  insert  an  unmatched  close  parenthesis.  Sec 
section  20.4  [Permit  Unmatched  Paren],  page  90. 

Read  Line  Delay  TTiis  is  the  amount  of  time,  in  30’lhs  of  a  second,  which  HMACS  should  wait  after  starting 
to  read  a  line  of  input,  before  it  prompts  and  starts  echoing  the  input. 

Region  Query  Size  (5000) 

Many  commands  which  act  on  the  region  require  confirmation  if  the  region  contains  more 
than  this  many  characters. 

Return  from  Superior  1  look  (nonexistent) 

If  this  variable  exists,  its  value  should  be  a  TFCO  program  to  be  executed  whenever 
HMACS  is  resumed  after  being  exited.  See  section  6.3  [Return  from  Superior  Hook], 
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page  26. 

Set  Mode  Line  Hook 

This  is  a  hook  which  is  executed  every  time  the  mode  line  is  recomputed.  It  can  insert  text 
in  die  buffer  to  put  it  in  the  mode  line  after  the  minor  modes.  See  section  1.1  [Set  Mode 
Line  Hook],  page  6. 


Space  Indent  Rag 

If  this  flag  is  nonzero,  then  Auto  Fill  indents  the  new  lines  which  it  creates,  by  performing 
a  Tab.  Most  major  modes  for  programming  languages  set  this  nonzero.  Sec  section  11.4 
{Space  Indent  Rag),  page  47. 

Tab  Stop  Definitions  (a  string) 

'Ihc  value  of  Tab  Stop  Definitions  is  a  string  defining  the  tab  stops  to  be  used  by  the 
command  M-I  ("R  Tab  to  Tab  Stop).  Sec  section  1 1.3  [Tab  Stop  Definitions],  page  46. 

Tags  Find  File  (nonexistent) 

If  tliis  variable  exists  and  is  not  zero,  TAGS  uses  C-X  C-F  to  switch  files.  Otherwise, 
'LAGS  uses  C-X  C-V.  Sec  section  21  [TAGS],  page  101. 

Temp  Rlc  FN2  List  (MKMOtOXGPtO  ...)  Ibis  is  a  TKCO  search  string  which  recognizes  the  filenames 
which  indicate  that  the  file  is  probably  temporary.  Sec  section  13.5  [Temp  File  FN2  List], 
page  59.  • 

Underline  Begin  (nonexistent) 

If  this  variable  exists,  its  value  should  be  the  character  or  string  to  use  to  begin  underlines 
for  the  M-_  command.  See  section  1 1.7  [Underline  Begin),  page  51. 

Underline  Fnd  (nonexistent) 

If  tliis  variable  exists,  its  value  should  be  the  character  or  string  to  use  to  end  underlines  for 
the  M-_  command.  Sec  section  1 1.7  [Underline  Fnd],  page  51. 

Visit  File  Hook  (nonexistent) 

If  this  variable  exists,  its  value  should  be  a  TFCO  program  to  be  executed  whenever  a  file 
is  visited.  Sec  section  13.1  [Visit  File  Hook],  page  55. 

WORDAB  Ins  Chars  (nonexistent) 

If  this  variable  exists  when  Word  Abbrcv  Mode  is  turned  on.  it  should  be  a  string 
containing  precisely  those  characters  which  should  terminate  and  expand  an  abbrcv.  Ihis 
variable  overrides  Additional  Abbrcv  l:x  panders  (q.v.).  Sec  section  25.2.1  [WORDAB), 
page  145. 
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Non-Control  Non-Meta  Characters: 

Backspace  tR  Backward  Character 

Tab  tR  indent  According  to  Mode 

Linefeed  tR  Indent  New  Line 

Return  tR  CRLF 

Altmode  tR  Prefix  f^ata 

Rubout  tR  Backward  Delete  Character 

Control  Characters: 


Alpha 
Altmode 
Space 
% 


0  thru 


> 
e 

A 
B 

c 

D 
E 
F 
G 
H 
I 
J 
K 
L 
H 
N 
0 
P 
0 
R 
S 
T 
U 

V 
W 
X 

Y 
Z 
\ 

3 

t 

Rubout 


tR  Complement  SAIL  Mode 
tR  Exit 

rR  Set/Pop  Mark 
tR  Replace  String 
tR  Negative  Argument 
tR  Argument  Digit 
tR  Indent  for  Comment 
rR  Mark  Beginning 
What  Cursor  Position 
tR  Mark  End 
tR  Set/Pop  Mark 
tR  Beginning  of  Line 
tR  Backward  Character 
tR  Prefix  Control-Meta 
tR  Delete  Character 
tR  End  of  Line 
tR  Forward  Character 
tR  Quit 

tR  Backward  Character 
tR  Indent  According  to  Mode 
tfi  Indent  New  Line 
tR  Kill  Line 
tR  New  Window 

tR  Self  Insert  for  Formatting  Character 

tR  Down  Real  Line 

tR  Open  Line 

tR  Up  Real  Line 

tR  Quoted  Insert  ■ 

tR  Reverse  Search 

tR  Incremental  Search 

tR  Transpose  Characters 

tR  Universal  Argument 

tR  Next  Screen 

tR  Kill  Region 

is  a  prefix  character.  See  below. 
tR  Un-kill 

tR  Return  to  Superior 

tR  Prefix  Meta 

Abort  Recursive  Edit 

tR  Prefix  Control 

tR  Backward  Delete  Hacking  Tabs 


KMAC'S  Command  Chart  (as  ot' 03/27/80) 


Meta  Characters: 


Linefeed 

tR 

Indent  New  Comment  Line 

Return 

tR 

Back  to  Indentation 

Altmode 

tR 

Execute  Minibuffer 

H 

tR 

Change  Font  Word 

% 

tR 

Query  Replace 

t 

tR 

Upcase  Digit 

( 

tR 

Make  () 

) 

tR 

Move  Over  ) 

- 

tR 

Negative  Argument 

. 

tR 

Find  Tag 

/ 

tR 

Describe 

0 

thru  9 

tR 

Argument  Digit 

• 

tR 

Indent  for  Comment 

< 

tR 

Goto  Beginning 

= 

tR 

Count  Lines  Region 

> 

tR 

Goto  End 

? 

tR 

Describe 

e 

tR 

Mark  Word 

A 

tR 

Backward  Sentence 

B 

tR 

Backward  Word 

C 

tR 

Uppercase  Initial 

0 

tR 

Kill  Word 

E 

tR 

Forward  Sentence 

F 

tR 

Forward  Word 

G 

tR 

Fill  Region 

H 

tR 

Mark  Paragraph 

I 

*  * 

tR 

Tab  to  Tab  Stop 

J 

tR 

Indent  New  Comment  Line 

K 

tR 

Kill  Sentence 

L 

tR 

Lowercase  Word 

M 

tR 

Back  to  Indentation 

N 

tR 

Down  Comment  Line 

P 

tR 

Up  Comment  Line 

0 

tR 

Fill  Paragraph 

R 

tR 

Move  to  Screen  Edge 

s 

tR 

Center  Line 

T 

tR 

Transpose  Words 

U 

tR 

Uppercase  Word 

V 

tR 

Previous  Screen 

W 

tR 

Copy  Region 

X 

tR 

Extended  Command 

Y 

tR 

Un-kill  Pop 

[ 

tR 

Backward  Paragraph 

\ 

tR 

Delete  Horizontal  Space 

] 

tR 

Forward  Paragraph 

t 

til 

Delate  Indentation 

*• 

tR 

Underline  Word 

~ 

tR 

Buffer  Not  Modified 

Ri 

ibout 

tR 

Backward  Kill  Word 

Rubout 
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Control-Meta 

Characters: 

Back 

space 

tR 

Hark  Defun 

Tab 

tR 

Indent  for  LISP 

Linefeed 

tR 

Indent  New  Comment  Line 

Return 

tR 

Back  to  Indentation 

( 

,  a 

tR 

Backward  Up  List 

) 

,  . 

tR 

Forward  Up  List 

- 

•  • 

tR 

Negative  Argument 

0  thru  9 

tR 

Argument  Digit 

l 

tR 

Kill  Comment 

? 

tR 

Documentation 

@ 

tR 

Mark  Sexp 

A 

tR 

Beginning  of  DEFUN 

B 

tR 

Backward  Sexp 

C 

•  • 

tR 

Exit 

D 

•  • 

tR 

Down  List 

E 

•  * 

tR 

End  of  DEFUN 

F 

•  • 

tR 

Forward  Sexp 

G 

•  ♦ 

tR 

Format  Code 

H 

•  • 

tR 

Mark  Defun 

I 

•  • 

tR 

Indent  for  LISP 

J 

•  • 

tR 

Indent  New  Comment  Line 

K 

•  • 

tR 

Kill  Sexp 

M 

•  • 

tR 

Back  to  Indentation 

N 

•  • 

tR 

Forward  List 

0 

tR 

oplit  Line 

P 

tR 

Backward  List 

Q 

tR 

Indent  SEXP 

R 

•  • 

tR 

Reposition  Window 

T 

•  • 

tR 

Transpose  Sexps 

U 

•  • 

tR 

Backward  Up  List 

V 

♦  • 

tR 

Scroll  Other  Window 

W 

tR 

Append  Next  Kill 

X 

tR 

Instant  Extended  Command 

C 

tR 

Beginning  of  DEFUN 

\ 

tR 

Indent  Region 

] 

tR 

End  of  DEFUN 

t 

,  , 

tR 

Delete  Indentation 

Rubout 

tR 

Backward  Kill  Sexp 

KM  ACS  Command  Chart  (as  of  03/27/80) 


Control-X 
tX  tB 

tX  tc 
tX  to 

tX  tF 
tX  Tab 
tX  tL 
tX  tN 
tX  tO 
tX  tP 
tX  tQ 
tX  tR 
tX  tS 
tX  tT 
tX  tU 
IX  tV 
tX  tW 
fX  tX 


is  an  escape  prefix  command  with  these 

List  Buffers 
tR  Return  to  Superior 
tR  Directory  Display 
Find  File 
tR  Indent  Rigidly 
tR  Lowercase  Region 
tR  Set  Goal  Column 
tR  Delete  Blank  Lines 
tR  Mark  Page 
tR  Do  Not  Write  File 
tR  Read  File 
tR  Save  File 
tR  Transpose  Lines 
tR  Uppercase  Region 
tR  Visit  File 
Write  File 

tR  Exchange  Point  and  Mark 


v  g  -  ■  V  UIIU  1'IUI  l\ 

tX  Altmode  tR  Re-execute  Minibuffer 


tX  ft 
tX  ( 
tX  . 
tX  1 
tX  2 
tX  3 
tX  4 
tX  ; 
tX  = 
tX  A 
tX  B 
tX  D 
tX  F 
tX  G 
tX  H 
tX  I 
tX  K 
tX  L 
tX  M 
tX  N 
tX  0 
tX  P 
tX  R 
tX  T 
tX  W 
tX  X 
tX  [ 
tX  ] 
tX  t 
tX  ♦- 


tR  Change  Font  Region 
tR  Start  Kbd  Macro 
tR  Set  Fill  Prefix 
tR  One  Window 
tR  Two  Windows 
tR  View  Two  Windows 
tR  Visit  in  Other  Window 
tR  Set  Comment  Column 
What  Cursor  Position 
tR  Append  to  Buffer 
Select  Buffer 
tR  Dired 

tR  Set  Fill  Column 

tR  Get  Q-reg 

tR  Mark  Whole  Buffer 

tR  Info 

Kill  Buffer 

tR  Count  Lines  Page 

Mail 

tR  Set  Bounds  Region 
tR  Other  Window 
tR  Set  Bounds  Page 
Read  Mail 

tR  Transpose  Regions 
tR  Set  Bounds  Full 
tR  Put  Q-reg 
tR  Previous  Page 
tR  Next  Page 
tR  Grow  Window 
tR  Underline  Region 


— . .  "“y  »  mu 

tX  Rubout  tR  Backward  Kill  Sentence 


index 


Index 


!  83 

&  Hxit  GMACS  27 
&  Alter  ..D  117 

.  83 

<cr>  9 

C-C  10.128 
C-CC-Y  128 
CMC  26.60.114 

Abbrcv  definition  files  144, 147 

Abbrcv  definition  lists  141, 144, 146, 147 

Ahbicv  profusion  147 

Abbrevs  141 

Abhrcvs  in  multitude  147 

Abort  Recursive  l-'dit  1 14. 129 

Aborting  129 

Accumulator  97 

Additional  Abbrcv  Expanders  146 
Address  97 

Alnnodc  9. 10. 20. 83. 84. 1 17. 126, 127 
Append  to  Hie  38.63 
Apropos  29 
ASCII  9 

Atom  word  mode  6. 44, 1 11 
Auto  Directory  Display  59 
Auto  fill  93 

Auto  fill  mode  6. 46. 47. 92, 1 1 1, 1 12, 1 18, 120 

Auto  Push  Point  Notification  32 

Auto  Push  Point  Option  32 

Auto  Save  Default  57,111 

Auto  Save  Filenames  58 

Auto  Save  Interval  59 

Auto  Save  Max  58 

Auto  save  mode  6,57,111 

Auto  Save  Visited  Hie  58 

Auloarg  mode  18, 157 

Autoloading  113 

HA  Rli  library  23 
Hit  prefix  characters  156 
Blank  line;  15. 3C.  45, 92. 93 
Buffer  Creation  Hook  59 
Buffers  6,67.74.102,118 

C-  9 
C-;  91 
C-<  32 
C->  32 
C-@  31 


C  M  )  95 
C-M-:  91 
C-M-@  32.95 
C-M-A  95.97 
C-M-B  94 
C-M-l)  95,97 
C-M-H  95.97 
C-M-l-  94 
C-M-G  97.98 
C-M-l  I  32,95 
C-M-K  35.95 
C-M-l.  79 
C-M-M  46.89 
C-M-N  94,97 
C-M-P  94,97 
C-M-Q  97 
C-M-R  72 
C-M-Ruboui  35,95 
C-M-Spacc  143.148 
C-M-T  95 
C-M-Tab  % 

C-M-U  95 
C-M-V  73 
C-M-W  37 
C-M-X  20 
C-M-(  95 
C-M-N  47,97 
C-M-)  95 
C-M-t  89.96 
C-N  13.85 
C-0  15,85.89 
C-P  13 

C-Q  13.85.143.147 
C-R  41.81,83,126.159 
C-Ruboul  93 
C-S  41.81,159 
C-Space  31 
C-T  13,53 
C-U  17,19.55 
C-UC-@  45 
C-V  71 

C-W  35.45.79,83 
C-X  10,85,118.121 
OX  it  50 

OX  l  142. 145. 146. 148 

OX-  142,146.  148 

C-Xl  73 

C-X 2  73 

C-X  3  74 

C-X  4  74 


Index 


C-XC-C  26 
C-XA  38 

C-XAIlmodc  21.84,128 
C-XB  67 

C-XC-A  142.145.148 

C-XC-B  68 

C-XC-D  59 

C-XC-F  67 

C-XC-II  142.148 

C-XC-L  50 

C-XC-0  15,35 

C-XC-P  32.79.80 

C-XC-S  14.55.58.68 

C-XC-T  54 

C-XC-U  31,50 

C-XC-V  14,55 

C-XC-W  58 

CX  C-X  31 

C-XD  62 

C-Xli  125 

C-XF  48.111 

C-XG  39 

C-X  II  32 

C-XJ  81 

C-XK  68 

C-XL  SO 

C-XN  77.83 

C-XO  73 

C-XP  79.81 

C-XQ  12b.  159 

C-XRuboul  35.45,53 

C-XT  54 

C-X  Tab  47 

C'-XU  148 

C-XW  77.79.81.83 

C-XX  39 

C-X*-  51 

C-X  (  125 

C-X  )  125 

C-X  .  48 

C-X  ;  92 

C-X  =  49 

C-X  [  79,81 

C-X  ]  79.81 

C-X  t  74. 128 

C-Y  37 

C-\  127 

C-]  60,34.114,117.129 
C-r  10 
C-*-  29 

Capitalisation  143 

Case  conversion  49,54,83. 141,157 

Ca-e  Replace  83 

Centering  48 
<  liaintiir  Seauh  42 
diameter  set  9 
(lean  Directory  60 
Gear  screen  71 
Comma  83 
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Command  completion  20. 23 

Commands  19 

Comment  Regin  93 

Comment  Column  92, 119 

Comment  lind  93 

Comment r  93,119 

Common'  81, 87. 91. 93. 94, 97. 116 

Compare  "  .tones  64 

Compile  C.  nand  88 

Confirmation  50. 56. 57. 61. 128. 142 

Continuation  line  13 

Control  9, 134 

Control-Meta  94 

Copy  Hie  63 

Create  Hie  56 

CR1.F  13 

Cursor  5 

Customization  22. 1 18. 120. 145 

Default  Separator  160 
Define  Word  Abbrevs  146 
Defining  abbrevs  142,144 
Defuns  32,95 
Delete  Hie  63 
Deletion  13.35.53.84,132 
IX'scribc  29. 115 
Directory  59.62.64 
Directory  l.istcr  59 
Dill  111)  59.60.  IP 
Display  Matching  h  .*  90 
Documentation  30 
Down  Picture  Mover  ■  t  151 
Dumped  environments  147 

I  Icho  area  5. 1 9, 49. 79, 142 
l;dil  Indented  Text  46 
lidit  key  156 
lldit  Options  26,114 
I'd  it  Picture  26,151 
lldit  Some  Word  Abbrevs  147 
Fdit  Syntax  Table  117 
lldit  Tab  Steps  43,47 
lidit  Word  Abbrevs  144 
HditorType  6 
lirror  message  5 
liscapckey  155 

KVARS  files  112.118,  120.145.  146 
licit  Hook  27 
lixiling  26 

lixpander  diameters  146 
I  lx  pnmling  abbrevs  143 
I  ;x tended  commands  19 

l-AH.  97 

llle  deletion  59.60 
Hie  directory  59 
Hie  Vcisitnis  Kept  60 
Hies  6.14.55.57.63.74.118 
Mil  Column  48,111.114 


jtlMMn* 


Mil  Prefix  45,48 
Mlling  47 
Mnd  File  102 
Mush  Lines  84 
Fonts  50 
Formatting  46.96 
Formfeed  79 
IS  Mags  117 
Functions  19 

Global  abbrevs  141, 145, 146 
Grinding  96 

Help  23.29.134 
1  Ionic  Directory  129. 133 
Hooks  148 
How  Many  84 

Incremental  abbrev  definition  files  147 

Indent  Tabs  Mode  47. 1 12 

Indentation  46.89.91.96 

lnit  file  157 

Init  files  120.145.146 

Insert  File  63 

Insert  Page  Directory  81 

Insert  Some  Word  Abbrevs  147 

Insert  Word  Abbrevs  146 

Insertion  13.63.79 

INTER  93 


Join  pages  81 
Journal  files  133 

Keep  Lines  62, 84 

Keyboard  macros  6. 125 

Kill  AH  Word  Abbrevs  146 

Kill  Huffcr  68 

Kill  Libraries  113,131 

Kill  ring  37.131 

Kill  Some  llufTcrs  68,105,131 

Killing  35.37.43.45.53.95.132 

Killing  abbrevs  143.  144. 146 

labels  97 

I  arge  numbers  of  abbrevs  147 
IJiDIT  6,93 

1  eft  Picture  Movement  151 

I  jbrarics  80, 1 12, 141, 151 

linefeed  46,87,89,96 

lines  35, 153 

lisp  89.111 

lisp  mode  93 

listlluffcrs  68 

list  Mias  59,63 

list  library  113 

1 1st  1  .onded  I  ibrarics  1 13 

1  ist  Some  Word  Abbrevs  147 

list  Variables  IIS 

list  Word  Abbrevs  144,146 


ill 
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lists  32.94,116 
Load  Library  112 
l-oading  112 
l^ocal  modes  lists  112 
l-ocal  variables  67.115.118 

M-  9 

«M-“  98 

M  -#  50 

M-%  84.127 

M-*  54.98,143.148 

SH  95 

M-)  95 

M-M-C  54 

M--M-L  54 

M-M-U  54 

M-.  103 

M-:  91 

NK  13 

M->  13 

M-@  32.44 

M-A  45 

M-Allniodc  127 

M-B  43 

M-C  49 

M-D  35.43 

M-I:  4j 

M-F  43 

M-G  48 

M-ll  32.45.48 

M-I  47 

M-J  92 

M-K  35.45 

M-L  49 

M-l.incfccd  92 

M-M  46.89 

M-N  92 

M-0  159 

M-P  92 

M-Q  48 

M-R  72 

M-Uubout  35.43.53 

M-S  48 

M-T  44 

M-U  49 

M-V  71 

M-W  37 

M-X  19.21 

M-Y  :i 

M*(  45.97 

M-\  35.46.89 

M-l  45.97 

M-t  35.46.80.96 

M-  51 

M.l.  115 

Macro- 10  97 

Macsyma  97 

Maesyma  mode  98 

MAILT  6 


Index 


WT 


Major  modes  6, 87. 92,  ]  17, 118. 141 
Make  Space  131 

Make  'ihese  Characters  Kxpand  146 

Make  Word  Abbrev  145 

Manyabbrevs  147 

Mark  31.36.37.44.45.63.79.95 

Matching  90 

Meta  9.43.134.155.156 

Mctizcr  9.127,156 

MIDAS  88,89,97 

MIDAS  mode  97 

Minibuffcr  21.26.62.71.84.127 

Minibuffer  Separator  160 

Minor  modes  6. 47,  111,  141 

MM  19.39 

Mode  abbrevs  141, 145, 146 
Mode  line  6. 26. 67. 80. 87.  Ill,  127 
More  line  6 

Motion  43. 45. 79. 94. 9S 
Moving  text  37 
Muddle  mode  93 

Name  Kbd  Macro  125 
Narrowing  49. 77. 79. 83 
Numeric  argument  142 

Numeric  arguments  17. 20. 22. 36. 38. 44. 47. 48. 49. 50. 51. 57. 59. 71. 73. 74. 83. 92.  %.  111.114.128.  156.157 


Occur  84 

Only  Global  Abbrevs  146 
Options  114 
Overwrite  mode  6.111 


PACK  80 

Page  Delimiter  45.80 
PACK  I-lush  CRI.F  81 
Pages  32  45.79.80.153 
Paragraph  Delimiter  45.98 
Paragraohs  32  44. 48, 93, 97, 153 
Parentheses  43,90 
Permit  Unmatched  Parcn  90 
Pictures  151 

Prefix  characters  10. 1 18. 121 
Prepend  to  Hie  38, 63 
Prcvcntingabbrev  expansion  143 
Printing  terminal  161 
Prompting  5,19 
PURIIT  library  98 


Q-rcgistcrs  39 

Query  Replace  83,  126, 127 

Quick  I  ist  Sonic  Word  Abbrevs  147 

Quit  133 

Quilting  42  12? 

Quoting  13, 147 


R  50,51 

Read  Incremental  Word  Abbrev  laic  147 
Read  Word  Abbrev  laic  144, 147 
Readable  Word  Abbrev  laics  144 


Reap  File  60 

Recursive  Editing  Level  26, 60. 68, 1 17, 129. 134. 144 

Redefining  abbrevs  142 

Redefining  commands  118,120 

Region  31. 36. 37.45, 50. 51. 63. 77. 79. 95. 97. 142, 153 

Rename  Buffer  68 

Rename  File  63 

Replace  String  83 

Replacement  83,84 

Replay  Journal  File  133 

Rcsiarting  131 

Return  9.13,55 

Revert  File  57.58 

Right  Picture  Movement  151 

RMA1L  6 

Rubout  9, 33.  14. 19. 35. 53. 83. 87. 93.  til.  126 
Run  Library  113 

S-expressions  94. 1 16 

SAII.characlcrs  155 

Save  All  Mies  68 

Saving  55.57 

Saving  abbrevs  144 

Screen  5.71 

Scrolling  71,73 

Searching  41.81,83 

Select  Buffer  67 

Sentences  44,53 

Set  Key  146 

Set  Variable  114 

Set  Visited  Filename  63 

Short  Display  Size  159 

Slow  Search  I-incs  159 

Slow  Search  Separator  160 

S!  OWI  ,Y  Maximum  Speed  160 

Son  Lines  153 

Sort  Pages  153 

Sort  Paragraphs  153 

Sorting  153 

Space  9.20.47,83.126 

Space  Indent  Mag  46, 49 

Split  pages  81 

SRCCOM  56.62 

Stan  Journal  Pile  133 

Siring  arguments  20.22,59,114 

String  Search  42 

Submodc  6 

Subroutines  23 

Syntax  table  43. 44. 90, 93, 95. 1 15 

Tab  43.46,87.89,93.% 

Tab  Slop  Definitions  47 
Tabiry  47 
Tags  74.113 
Tags  Mud  File  102 
Tags  Search  IDS 

IFCO  19.21.39.45,49.63.71.85.88.89.90. 113. 115. 117. 120. 125, 131 
ITCO  default  filenames  63 
THCOmodc  98 


Tl-CO  search  string  60. 85. 104 

Temp  MlcFN2  list  60 

Terminal  type  131 

Tex!  justifies  50.51 

Text  mode  43.90 

Text  Mode  Hook  90 

TJ6  50 

Toggling  111 

Too  many!  147 

Top  Level  129.131 

Transposition  44.53.95 

Two  window  mode  73 

Types  53.54 

Underline  Begin  51 
Underline  End  51 
Underlining  51 
Undo  37.50.57. 131.132 
Unexpanding  abbrexs  143 
Unlnbify  47 

Up  Picture  Moxement  151 
URK  131 
Usage  count  144 
User  Name  120 

Variables  114.120 
View  Buffer  72 
View  Directory  59 
View  111c  63 
View  Kbd  Macro  126 
View  Page  Directory  81 
Visit  (lie  63 
Visit  lag  Table  102 
Visiting  14. 55.  S7. 67. 74 

W2  73 

What  Cursor  Position  49 
What  Page  79 
Windows  73 

Word  Ahbrev  Apropos  147 

Word  Abbrev  I  look  148 

Word  abbrev  mode  6.  i  1 1. 141. 142, 146 

Word  abbrev  profusion  147 

Word  Search  42 

WORDAB  141 

WORDAI1  DEEMS  144 

WORDAB  Ins  Chars  146 

WORDAB  Setup  Hook  148 

Words  32. 43. 49. 50. 51. 53, 54. 116 

Write  Hie  58.63 

Write  luctcmcntn!  Word  Abbrev  Hie  147 
Write  Word  Abbrev  Hie  144. 14? 

r  83 

t  R  Abbrex  Expand  Only  143 
rR  Add  Global  Word  Abbrev  142,  145, 146 
tR  Add  Mode  Word  Abbrev  14?,  145 
tR  Edit  Quietly  159 

rll  Inverse  Add  Glolrat  Word  Abbrev  142.  145. 146 


212 


KM  ACS  Manual  for  ITS  Users 


*R  Inverse  Add  Mode  Word  Abbrev  142. 145 
iR  Kill  Globa!  Word  Abbrev  146 
tR  Kill  Mode  Word  Abbrev  146 
t  R  Set  Screen  Sire  159 

tR  Slow  Display  I-Scareh  159 

tR  Slow  Reverse  Display  I-search  159 

tR  Word  Abbrev  Prefix  Mark  143 

tR  Append  Next  Kill  37 

tR  Append  to  Buffer  38 

tR  Back  to  Indentation  46 

tR  Backward  Character  13 

tR  Backward  Delete  Character  13.35.53.93 

tR  Backward  Delete  Hacking  Tabs  93 

tR  Backward  Kill  Sentence  35.45,53 

tR  Backward  Kill  Scxp  35.95 

tR  Backward  Kill  Word  35.43,53 

tR  Backward  list  94 

tk  Backward  Paragraph  45.97 

tR  Backward  Sentence  45 

tR  Backward  Scxp  94 

tR  Backward  IT.C'0 Conditional  98 

tR  Backward  Up  list  95 

tR  Backward  Word  43 

tR  Beginning  ofDcfun  95 

tR  Beginning ofl  ine  13 

tR  Center  line  48 

tR  Change  l  orn  Region  50 

tR  Change  Font  Word  50 

tR  Copy  Region  37 

tR  Count IincsRage  80 

tR  CRL1-  13.87 

tR  Delete  Blank  lines  15,35 

tR  Delete  Character  35 

tR  Delete  1  lorizomal Space  35.46.89 

tR  Delete  Indentation  35.46.89.96 

*  R  Directory  Display  59 

tR  DIR1-D  62 

tR  Down  Comment  line  92 

tR  Down  list  95 

tR  Down  kcal  line  13 

»K  Iind  Kbd  Macro  125 

tR  I -nd  ofDcfun  95 

tR  laid  of  line  13 

tR  Fxchange  I'cint  and  Mark  31 

tR  licaitc  Kbd  Macro  125 

tR  Fxcouc  Mini  buffer  127 

tR  lerit  26.114 

tR  lill  Paragraph  48 

tR  Mil  Region  48 

tR  MndMIe  67 

tR  format  Code  97 

tR  Forward  Character  13 

tR  Forward  list  94  . 

tR  Forward  Paragraph  45.97 

tR  Forward  Sentence  4S 

tR  Forward  Scxp  94 

tR  Forward T1  SCO Conditional  98 

tR  Forward  Up  list  95 

tR  forward  Word  43 


Index 


tR  Get  Q-reg  39 
tR  Go  to  AC  Held  97 
tR  Go  to  Address  Field  97 
tR  Go  to  Next  Label  97 
tR  Go  to  Previous  Libel  97 
tR  Goto  Beginning  13 
tR  Goto  End  13 
tR  Goto  Next  Page  81 
tR  Goto  Page  80 
tl<  Goto  Previous  Page  81 
tR  Grow  Window  74, 128 
tR  Incremental  Search  41,81 
tR  Indent  for  Comment  91 
tR  Indent  for  Lisp  93,96 
tR  Indent  Nested  98 
tR  Indent  New  Comment  Line  92 
tR  Indent  New  Line  46,87,89,96 
tR  Indent  Region  47, 97 
tR  Indent  Rigidly  47 
tR  Indent  Sexp  97 
tR  lii.tciiO  95 
tR  Insert  Pagemark  81 
tR  Instant  Intended  Command  20 
tR  Join  Next  Page  81 
tR  Kbd  Macro  Query  126 
tR  Kill  Comment  91 
tR  Kill  Line  35 
tR  Kill  Region  35 
tR  Kill  Sentence  35,45 
tR  Kill  Sexp  35.95 
tR  Kill  Terminated  Word  97 
tR  Kill  Word  35,43 
tR  I  owcrcase  Region  50 
tR  I  owcrcase  Word  49, 54 
tR  Mark  Beginning  32 
tR  Mark  Dcfun  32,95 
tR  Mark  End  32 
tR  Mark  Page  32,79 
tR  Mark  Paragraph  32,45 
tR  Mark  Sexp  32,95 
tR  Mark  Whole  Buffer  32 
tR  Mark  Word  32,44 
tR  Move  Over)  95 
tR  Move  to  Screen  Edge  72 
tR  New  Window  13,71,161 
tR  Next  Page  79 
tR  Next  Screen  71 
tR  One  Window  73 
tli  Open  Line  15 
tR  Ollier  Window  73 
•R  Previous  Page  79 
R  Picvious  Screen  71 
<R  I'm  Q-rcg  39 
«R  Q  oi y  Replace  84. 127 
tR  Quoicd  Insert  13 
tR  Rc-exccutc  Minilniffcr  21,84,128 
tR  Reposition  Window  T 
tR  Return  lo  Superior  26 
tR  Reverse  Search  41,81 


214 


HMACS  Manual  for  ft's  Users 


tR  Save  File  14.55,68 
tR  Scroll  Olher  Window  73 
tR  Set  Bounds  Full  77.83 
rR  Set  Bounds  Page  79 
tR  Set  Bounds  Region  77.83 
tR  Set  Comment  Column  92 
tR  Set  Fill  Column  48,111 
tR  Set  Fill  Prefix  48 
tR  Set/Pop  Mark  31 
tR  Start  Kbd  Macro  125 
tR  Tab  to  Tab  Stop  43,47 
tR  Transpose  Characters  13,53 
tR  Transpose  Lines  54 
tR  Transpose  Regions  54 
tR  Transpose  Sexps  95 
tR  Transpose  Words  44 
tR  Two  Windows  73 
rR  Un-kill  37 
tR  Uu  kill  Pop  37 
tR  Underline  Region  51 
tR  Underline  Word  51 
tR  Universal  Argument  17 
tR  Up  Comment  Line  92 
tR  Up  Real  Line  13 
tR  Upca.se  Digit  54 
tR  Uppercase  Initial  49,54 
tR  Uppercase  Region  31,50 
tR  Uppercase  Word  49,54 
tR  View  Two  Windows  74 
tR  Visit  MIc  14.55 
tR  Visit  in  Other  Window  74 
tR  Widen  Hounds  81 


